# walkai-talkai troubleshooting guide

Source: https://walkai-talkai.com/troubleshooting (TR: /tr/sorun-giderme). Steps are ordered: most likely cause first.
Station state: curl -s http://127.0.0.1:1988/api/status . Do not send /api/reply test announcements without the user's consent (real radio transmission).

## English

### Cables and setup

#### [wiring-basics] How do I connect the radio to the Mac?
1. You need two radios on the same channel: one in your hand, one next to the Mac (the station radio).
2. Station radio SPEAKER output (SP, usually the 3.5 mm plug of a Kenwood-style 2-pin K-plug) → Mac input (USB sound card mic/line in).
3. Mac output (USB sound card headphone out) → station radio MIC input (usually the 2.5 mm plug of the K-plug).
4. In the app: Audio Settings → Input Microphone = the sound card that receives the radio, Output Speaker = the sound card that feeds the radio.
5. A cheap USB sound card with separate mic and headphone jacks is the most reliable option. A ready-made "radio to PC interface cable" (APRS / digital-mode cable) with built-in attenuation is ideal.

#### [mac-jack] Can I use the MacBook headphone jack instead of a USB sound card?
1. The Mac headphone jack is a combo TRRS (CTIA) jack: it only accepts a microphone through a 4-pole headset plug. A 3-pole (TRS) radio cable will usually give output but no input.
2. Use a TRRS splitter (headset → separate mic and headphone) if you want to use the built-in jack, or better, a USB sound card.
3. Check Audio Settings: the input must show "External Microphone" or the sound card name, not "MacBook Microphone".

#### [swapped-jacks] Nothing works in either direction
1. The two plugs are probably swapped: radio SP must go to the Mac INPUT, radio MIC must come from the Mac OUTPUT.
2. Make sure the K-plug is pushed all the way in; many radios need a firm push and the plug sits slightly proud of the case.
3. Check that both radios are on the same channel/frequency and the same CTCSS/DCS code (or both off).
4. Use the Test buttons: Audio Settings → microphone card "Test" (records and plays back) and speaker card "Test" (sends a sample announcement).

#### [radio-settings] Which radio settings matter?
1. Station radio: VOX ON (sensitivity around 3–5 of 9 to start), squelch 3–5, battery save OFF, dual watch OFF, TOT (transmit time-out) at least 60–120 s, roger beep optional.
2. Handheld: VOX off (you use PTT), same channel and CTCSS/DCS code as the station radio.
3. Volume knob on the station radio sets how loud your voice reaches the Mac; start at about 50–60 %.
4. Some radios disable VOX while an accessory cable is plugged in, or require a separate "VOX on accessory" option; check the radio manual.

#### [usb-hub] The USB sound card disconnects or crackles
1. Plug the sound card directly into the Mac or into a powered hub; unpowered hubs and long adapters cause dropouts and crackle.
2. Avoid USB-C adapters that also charge the Mac through the same dongle if you hear buzzing.
3. After reconnecting, walkai-talkai rebuilds its audio engine automatically within a few seconds. If listening still does not resume, toggle listening off and on (Station tab or menu bar panel).

### Not hearing my voice

#### [not-hearing] I talk on the radio but nothing happens
1. Check that listening is on: the Station tab says Listening Active, its spectrum moves while you talk and the menu bar star blinks green.
2. Audio Settings → Input Microphone must be the sound card connected to the station radio SP output.
3. Use the microphone "Test" button: talk on the handheld while it records, then listen to the playback. Silence means the audio never reaches the Mac (cable, jack, radio volume).
4. Turn up the station radio volume knob; if it is near zero the Mac receives almost nothing.
5. macOS System Settings → Sound → Input: select the sound card and raise its input volume; you should see the level meter move when you talk.
6. macOS microphone permission: System Settings → Privacy & Security → Microphone → walkai-talkai must be on.

#### [voice-isolation] Voice comes through weak, choppy or not at all
1. macOS Mic Mode may be set to Voice Isolation: it treats radio audio as background noise and removes it. Open Control Center (menu bar) → Mic Mode → choose Standard while walkai-talkai is listening.
2. Turn off "Use ambient noise reduction" for the input device if your Mac shows it in Sound settings.
3. Other apps that process the microphone (Krisp, NVIDIA Broadcast-style tools, virtual audio devices) can also suppress radio audio.

#### [stops-listening] It worked, then stopped hearing me (after sleep or a device change)
1. macOS stops the audio engine when devices change (sleep and wake, AirPods/Bluetooth connecting, USB replug). walkai-talkai detects this and rebuilds listening within a few seconds.
2. If it does not recover, toggle listening off and on from the Station tab or the menu bar panel.
3. Bluetooth headphones can become the default input/output; make sure Audio Settings still points to the radio sound card.

#### [squelch-noise-rx] It keeps recording noise or triggers by itself
1. Raise the squelch on the station radio so it is silent when nobody transmits; an open squelch sends constant hiss that sounds like speech.
2. Use a CTCSS/DCS code on both radios so other users on the channel do not open your station.
3. Low-frequency rumble and desk thumps are filtered out automatically, but continuous hiss is not; fix it at the radio.
4. Use a USB microphone? Make sure the Input Microphone is the radio sound card, not a room mic that hears everything.

#### [other-users] Someone else on the channel triggered a command
1. Anyone on the same frequency can be heard by the station radio. Use an uncommon channel and a CTCSS/DCS code, and keep the station radio power low.
2. Make your agent ask for confirmation before irreversible actions (deleting, pushing, deploying). Announcements and AI replies are also audible to everyone on the frequency.
3. Pause listening when you are not using the station.

#### [mic-test-silent] The microphone test plays nothing
1. The test recording plays through the current macOS system output (Sound → Output). Raise its volume.
2. If the recording is silent, the input is not receiving audio: check the input device, cable and radio volume (see "I talk on the radio but nothing happens").
3. The microphone test is never sent to Whisper or the AI.

### Wrong or missing words

#### [wrong-words] It understands the wrong words
1. Settings → Speech recognition: switch to Whisper Large v3 Turbo (about 1.5 GB download). It is far more accurate, especially for Turkish with English technical terms.
2. Settings → Language must match the language you speak; recognition uses the selected language.
3. Speak 10–15 cm from the handheld mic, at normal volume; shouting distorts FM audio.
4. Set the station radio volume so the microphone Test sounds clear and not clipped.

#### [cut-sentence] My command is cut in half or split into two
1. A command ends after about 1.3 seconds of silence. Avoid long pauses mid-sentence; keep PTT pressed and keep talking.
2. Release PTT only after you finish speaking.
3. If your handheld has battery save or a slow squelch, the start of a transmission may be lost; turn battery save off on both radios.

#### [first-word-missing] The first word of my command is missing
1. Press PTT, wait half a second, then speak. Radios need a moment to key up and open squelch.
2. Turn off battery save on the station radio; in power-save mode it wakes up late and misses the start.
3. Use a CTCSS/DCS code only if needed; some radios add a short delay before opening on a tone.

#### [hallucination] A command appeared that nobody said
1. Whisper can invent text from noise. walkai-talkai filters common phantom phrases and ignores low-frequency rumble, but continuous hiss can still pass.
2. Raise the squelch, use CTCSS/DCS, and make sure the input is the radio sound card rather than a room microphone.
3. Check Command History: every received command is saved with its audio, so you can hear what triggered it.

#### [wrong-language] It writes in the wrong language
1. Recognition uses the language selected in Settings → Language (Turkish or English); it does not auto-detect. Pick the language you speak.
2. Switching the language also starts a fresh AI session in API Mode, so old context does not mix languages.

#### [turbo-download] The Large v3 Turbo download fails or never finishes
1. It is about 1.5 GB; you need a stable connection and at least 2 GB free disk space.
2. Cancel and retry from Settings → Speech recognition. A partial or corrupted file is rejected and the bundled Base model stays active.
3. Whisper Small (about 470 MB) is a good middle ground on slow connections.

#### [slow-recognition] Recognition takes too long
1. Large v3 Turbo is the most accurate but heaviest model. On an M1 with many apps open, try Whisper Small or Base.
2. Long commands take longer; keep commands short and specific.
3. Low Power Mode on a MacBook slows recognition; plug in or turn it off.

### Announcements over the radio

#### [no-transmit] Announcements are not transmitted
1. Audio Settings → Output Speaker must be the sound card connected to the station radio MIC input.
2. Output channel: most radio cables use only one side. Default is Right; if nothing goes out, try Left or Stereo.
3. Press the speaker "Test" button and watch the station radio: its TX LED should light. If not, VOX is not opening (see VOX entries) or the cable is in the wrong jack.
4. macOS Sound → Output: select the sound card and set its volume high (80–100 %). The app's own level is applied on top of it.
5. Make sure VOX is turned on in the station radio menu.

#### [first-word-cut-tx] The beginning of announcements is cut off
1. The radio VOX needs time to key up. Increase Audio Settings → Advanced Audio Settings → VOX Wake-Up Duration (default 750 ms, range 0–2500 ms) in 250 ms steps.
2. Add a pre-speech hold (0–1500 ms) so the radio is fully transmitting before speech starts.
3. Choose an alert sound (Tactical 3-tone, Motorola chirp…) before speech: it opens VOX and warns the listener.
4. Turn off battery save on the receiving handheld; it may wake up late.

#### [end-cut-tx] The end of announcements is cut off
1. Raise Audio Settings → Advanced Audio Settings → Post-Speech Tail (0–2000 ms, default 200 ms): the radio keeps transmitting a little longer after the last word.
2. Increase the VOX delay (hang time) in the radio menu so it keeps transmitting a little after speech ends.
3. Every announcement ends with a roger beep; if you never hear it, the radio is dropping the last part.
4. Check the radio TOT (time-out timer): very long announcements are cut when TOT expires. Set it to 60–120 s or more.

#### [vox-drops] VOX drops in the middle of announcements
1. Raise Audio Settings → Advanced Audio Settings → VOX Hold Tone Level (default 50 %). A quiet 82 Hz tone keeps VOX open during pauses between words.
2. Raise the radio VOX sensitivity one step, or lengthen its VOX delay.
3. If the output is very low (Announcement Output Level near 20 %), VOX may not detect speech reliably; raise it.

#### [distorted-tx] Announcements sound distorted or too loud
1. Lower Audio Settings → Advanced Audio Settings → Announcement Output Level (20–100 %, default 100 %). A radio MIC input expects a few millivolts; a headphone output is much hotter.
2. Lower the macOS output volume of the sound card to about 50–70 %.
3. Use a cable with an attenuator (10–30 dB) or lower the radio mic gain in its menu if it has one.
4. Choose Output channel Right or Left instead of Stereo if the cable sums both sides.

#### [quiet-tx] Announcements are too quiet on the handheld
1. Raise Audio Settings → Advanced Audio Settings → Announcement Output Level and the macOS output volume of the sound card.
2. Check the Output channel: with the wrong side selected only a faint crosstalk reaches the radio.
3. Turn up the handheld volume; also try a different pre-speech sound so you can hear when it starts.

#### [tx-own-echo] The station hears its own announcement
1. walkai-talkai ignores the input while transmitting and for 1.5 s afterwards, so its own voice is not treated as a command.
2. If a command still appears, the station radio is probably receiving a strong echo or another nearby radio; increase distance between radios and lower power.

#### [ack-beep] A short beep is sent after every command
1. That is the delivery beep: it confirms the command reached the agent or the AI. Turn it off in Settings → Play a confirmation sound when a command is sent.

#### [announce-language] Announcements are spoken in the wrong language or accent
1. The spoken language follows Settings → Language. Turkish uses the Turkish neural voice, English the English one.
2. An agent can override it for a single announcement by sending "lang": "en" or "tr" to /api/reply.

#### [mode-announcements] It announces mode or language changes over the radio
1. Settings → Spoken notice on mode and language change: turn it off if you do not want these notices on the air.

### Levels, left/right, volume

#### [levels-guide] What levels should I start with?
1. Station radio volume knob: about 50–60 %. Mac input volume for the sound card: about 50–70 %.
2. Mac output volume for the sound card: 70–100 %. App Announcement Output Level: 100 %, lower it if announcements distort.
3. Radio VOX sensitivity: 3–5 of 9. App VOX wake delay: 750 ms. VOX hold tone: 50 %. Noise gate: 60 %.
4. Change one thing at a time and use the two Test buttons after each change.

#### [left-right] Left, right or stereo output?
1. Many radio interface cables connect only one channel of the headphone plug to the radio MIC; the other may touch the PTT or speaker line and cause trouble.
2. Start with Right (default). If the radio does not key up during the speaker Test, try Left, then Stereo.
3. The setting is applied digitally inside the app, so the macOS balance slider does not matter; keep it centered anyway.

#### [input-clipping] My recorded voice is distorted (input too loud)
1. Lower the station radio volume knob; this is the most common cause.
2. Lower the Mac input volume of the sound card. walkai-talkai also lowers it step by step automatically if it keeps clipping.
3. Speak at normal volume and not too close to the handheld mic.

#### [input-too-low] My voice reaches the Mac too quietly
1. Turn up the station radio volume knob and the Mac input volume of the sound card.
2. If your sound card has a line/mic switch, use mic (more gain).
3. The app levels quiet speech before recognition, but a near-silent signal cannot be recovered.

#### [system-sounds] Notification sounds or music go out over the radio
1. If the radio sound card is the macOS default output, every app plays through the radio. In System Settings → Sound → Output choose your speakers or headphones.
2. walkai-talkai sends announcements to the device selected in Audio Settings regardless of the macOS default.
3. Also set System Settings → Sound → "Play sound effects through" to your speakers.

#### [sample-rate] Audio is robotic, too fast/slow or crackly
1. Open Audio MIDI Setup (Applications → Utilities), select the sound card and set it to 48,000 Hz (or 44,100 Hz), 2 channels, for both input and output.
2. Restart listening after changing the format.
3. Cheap sound cards sometimes misbehave at 96 kHz; avoid it.

### Noise, hum, stuck transmit

#### [tx-stuck] The radio stays in transmit (VOX stuck) with noise
1. Test with walkai-talkai closed. If the radio still keys up, the cause is the hardware path: noise or hum from the sound card output is opening VOX.
2. Unplug the cable from the sound card: if transmitting stops, it is the audio line. Lower the radio VOX sensitivity, lower the macOS output volume, or add a ground loop isolator.
3. Make sure the radio sound card is not the macOS default output (notifications and other apps would key the radio).
4. Lower the app VOX hold tone level; set it to 0 % if your radio holds VOX without it.
5. If the radio keeps transmitting even with the cable unplugged, the radio PTT/VOX itself is stuck: turn the radio off and on.
6. Inside the app a transmission is always force-ended after a timeout, so the app cannot keep the radio keyed forever.

#### [ground-loop] There is a constant hum or buzz
1. Classic ground loop: Mac on the charger + USB sound card + radio on its own charger. Try running the Mac on battery; if the hum disappears, add a ground loop isolator (audio isolation transformer) on the line between Mac and radio.
2. Move the radio charger to the same power strip as the Mac.
3. Use short, shielded cables and keep them away from power adapters.

#### [rf-feedback] Squeal or garbage only while transmitting (RF feedback)
1. The station radio antenna is too close to the cable or the Mac and its RF gets into the audio line.
2. Move the radio away from the Mac (or use an external antenna), lower the transmit power, and clip ferrite cores on the audio cable near both ends.

#### [hold-tone-audible] I hear a low hum under announcements
1. That is the VOX hold tone (82 Hz) that keeps the radio transmitting during pauses. Lower Audio Settings → Advanced Audio Settings → VOX Hold Tone Level, or set it to 0 % if VOX stays open without it.
2. Some radios filter it with CTCSS settings; others pass it through. Find the lowest level that still keeps VOX open.

#### [tone-after] A constant tone continues after the announcement ends
1. That is the VOX hold tone playing until the roger beep. Lower Audio Settings → Advanced Audio Settings → Post-Speech Tail (default 200 ms).
2. If the tone continues after the roger beep, it comes from the radio or the cable, not from walkai-talkai: see "The radio stays in transmit".

#### [hiss-gaps] Hiss is heard between words
1. Raise Audio Settings → Advanced Audio Settings → Noise Gate (0–100 %, default 60 %). It silences the background between words.
2. Too high a gate can clip quiet word endings; lower it a little if speech sounds chopped.

#### [static-bursts] Random clicks, pops or crackle
1. Check the cable and plug: a loose K-plug or a broken cable crackles when touched.
2. USB power issues cause pops; try another USB port or a powered hub.
3. Wi-Fi/Bluetooth adapters and phones near the cable can cause buzzing bursts; move them away.

### Target Window and agents

#### [paste-not-working] Commands are not typed into my agent (Target Window mode)
1. Grant Accessibility permission: System Settings → Privacy & Security → Accessibility → walkai-talkai on. A red dot on the menu bar icon means it is missing.
2. After an update macOS sometimes needs the permission re-granted: remove walkai-talkai from the list and add it again.
3. Pick the target again: menu bar panel → Pick target (or right-click the icon → Select Target Input), then click the agent's input box.
4. Some apps block simulated typing in secure fields (password boxes) or when Terminal's "Secure Keyboard Entry" is on; turn that off.

#### [wrong-window] It types into the wrong window or place
1. The target is a point on screen relative to the selected app window. If you moved or resized the window, pick the target again.
2. Keep the target app open (not minimized) and on the same desktop Space.

#### [agent-silent] My agent works but never answers over the radio
1. The agent must know the radio protocol. In the Target Window tab press "Send to Target" to paste the starter prompt into the agent once per session.
2. The prompt tells the agent to POST to http://127.0.0.1:1988/api/reply. Agents that block network or shell access (sandbox, permission prompts) must be allowed to run curl.
3. Old prompts may still contain port 8765; walkai-talkai migrates saved prompts to 1988, but prompts already pasted into an agent conversation must be updated there.
4. Test it yourself: curl -s -X POST http://127.0.0.1:1988/api/reply -H "Content-Type: application/json" -d '{"text":"Test, over."}'

#### [agent-talks-too-much] The agent reads long text or code over the radio
1. Edit the starter prompt (Target Window tab) and stress: maximum 2–4 short sentences, never read code, end with "over" / "tamam". Send it to the agent again.
2. In API Mode, adjust the starter prompt in API Settings the same way.

### API Mode (AI providers)

#### [api-401] API Mode says the API key is invalid (401)
1. Open API Settings → edit the profile and paste the key again without spaces. Keys for OpenAI, Anthropic, Gemini and DeepSeek are different; each needs its own.
2. Check that the key is active and the account has billing enabled at the provider.

#### [api-429] API Mode says the quota or rate limit is exceeded (429)
1. Your provider account hit its rate or spending limit. Wait a minute, check billing, or switch to another profile.

#### [api-404] API Mode says the model was not found (404)
1. The model name is wrong or retired. Edit the profile and choose a model from the refreshed model list.

#### [api-timeout] API Mode times out or cannot reach the server
1. Check the internet connection; API Mode needs it (speech recognition and voice do not).
2. Corporate networks and VPNs can block AI providers; try another network.
3. For a custom endpoint, check the URL (it must end with /v1 for OpenAI-compatible servers).

#### [ollama] Ollama (local) does not answer
1. Start Ollama and make sure a model is pulled (for example "ollama pull llama3.1").
2. The endpoint is http://localhost:11434/v1. Pick the exact model name shown by "ollama list".
3. Large local models are slow on small Macs; announcements will wait for the full answer.

#### [api-context] The AI forgets what we talked about
1. Each profile and model has its own sessions. Switching profile/model or language starts or resumes a different session.
2. Pick the session in API Settings → Conversation session, or keep context enabled.

### Local API (port 1988)

#### [localapi-refused] curl to 127.0.0.1:1988 fails (connection refused)
1. walkai-talkai must be running. The API listens only on 127.0.0.1 (not on your network).
2. Another app may be using port 1988: run "lsof -nP -iTCP:1988 -sTCP:LISTEN" in Terminal to see which.
3. Old prompts or scripts may still use 8765; update them to 1988.

#### [localapi-403] /api/reply returns 403
1. The license is not active. Activate it in About → License; announcements through the API require an active license.

#### [localapi-json] /api/reply returns 400 (invalid JSON)
1. Send a JSON body like {"text": "..."} with Content-Type: application/json; charset=utf-8.
2. Escape quotes inside the text, and make sure the shell does not break UTF-8 characters (use single quotes around the JSON in zsh/bash).

### License and purchase

#### [license-activate] My license will not activate
1. Copy the key exactly as in the email (WALKAI-XXXX-XXXX-XXXX). It is not case sensitive.
2. Activation needs internet once. Check your connection and firewall.
3. A license works on one Mac at a time. If it is active on another Mac, remove it there (About → License → Remove from This Mac) and activate again.
4. If the old Mac is gone, contact support with your purchase email to reset the activation (see walkai-talkai.com/license).
5. Need the app again? Download it with your key at walkai-talkai.com/license.

#### [license-lost] I lost my license key
1. Without the app: go to walkai-talkai.com/license, enter your purchase email and we email the key together with a download link.
2. In the app: activation window or About → License → "I lost my key", then enter your purchase email.
3. Check spam. Requests are rate limited; wait a few minutes before trying again.

#### [license-offline] The app asks for the license again after being offline
1. The license is re-checked online from time to time; between checks the app works offline for up to 14 days. About → License shows the last check and the days left.
2. Connect to the internet and open the app; the check happens automatically.

#### [license-move] How do I move my license to a new Mac?
1. On the old Mac: About → License → Remove from This Mac. On the new Mac: enter the same key.

### App, macOS and updates

#### [menu-bar] Where are the controls in the menu bar?
1. Left-click the menu bar icon to open the panel: status, mode, last command, pick target, test broadcast, input device, language, settings and quit.
2. Right-click (or Control-click) the icon for the classic menu.
3. The star in the icon blinks green while receiving and orange while transmitting. A red dot means Accessibility permission is missing.

#### [mic-permission] macOS asks for microphone permission or listening does nothing
1. System Settings → Privacy & Security → Microphone → turn walkai-talkai on, then restart listening.
2. If walkai-talkai is not in the list, quit and reopen it so macOS asks again.

#### [updates] How do I update? The update does not show
1. About → Check for Updates. Updates are signed and notarized and delivered in the app.
2. If no update appears you already have the latest version; the About tab shows your version.

#### [crash-report] macOS says walkai-talkai quit unexpectedly
1. Update to the latest version (About → Check for Updates); a crash on quit was fixed.
2. If it keeps happening, send the report text to support (the "Report…" button in the macOS dialog shows it).

#### [auto-start] It starts listening right after launch
1. Listening is on by default so the station is ready. Pause it from the Station tab or the menu bar panel when you do not need it.
2. If the input is a room microphone, sounds at startup can be treated as speech; use the radio sound card as input.

#### [legal] Is it legal to use my radio this way?
1. Frequencies, transmit power, licensing and rules about automated or unattended transmissions differ by country and band (PMR446, FRS, GMRS, amateur radio…).
2. You are responsible for complying with your local rules. Remember that anyone on the frequency can hear the announcements.

## Türkçe

### Kablo ve kurulum

#### [wiring-basics] Telsizi Mac'e nasıl bağlarım?
1. Aynı kanalda iki telsiz gerekir: biri elinizde, biri Mac'in yanında (istasyon telsizi).
2. İstasyon telsizinin HOPARLÖR çıkışı (SP; Kenwood tipi 2-pin K-fişin genelde 3,5 mm ucu) → Mac girişi (USB ses kartının mikrofon/line girişi).
3. Mac çıkışı (USB ses kartının kulaklık çıkışı) → istasyon telsizinin MİKROFON girişi (K-fişin genelde 2,5 mm ucu).
4. Uygulamada: Ses Ayarları → Giriş Mikrofonu = telsizin sesini alan ses kartı, Çıkış Hoparlörü = telsize ses veren ses kartı.
5. Ayrı mikrofon ve kulaklık girişi olan ucuz bir USB ses kartı en güvenilir seçenektir. İçinde zayıflatıcı olan hazır "telsiz-PC arayüz kablosu" (APRS / dijital mod kablosu) idealdir.

#### [mac-jack] USB ses kartı yerine MacBook kulaklık girişini kullanabilir miyim?
1. Mac'in kulaklık girişi kombine TRRS (CTIA) girişidir: mikrofonu yalnızca 4 kutuplu kulaklık fişiyle alır. 3 kutuplu (TRS) telsiz kablosunda genelde çıkış çalışır, giriş çalışmaz.
2. Dahili girişi kullanacaksanız TRRS ayırıcı (kulaklık → ayrı mikrofon ve kulaklık) kullanın; daha iyisi USB ses kartıdır.
3. Ses Ayarları'nda giriş "Harici Mikrofon" veya ses kartının adı olmalı, "MacBook Mikrofonu" değil.

#### [swapped-jacks] İki yönde de hiçbir şey çalışmıyor
1. Fişler büyük olasılıkla ters takılı: telsizin SP ucu Mac GİRİŞİNE, telsizin MIC ucu Mac ÇIKIŞINDAN gelmeli.
2. K-fişin sonuna kadar girdiğinden emin olun; birçok telsizde fiş sıkı girer ve gövdeden biraz dışarıda kalır.
3. İki telsizin aynı kanalda/frekansta ve aynı CTCSS/DCS kodunda (veya ikisinde de kapalı) olduğunu kontrol edin.
4. Test düğmelerini kullanın: Ses Ayarları → mikrofon kartındaki "Test Et" (kaydedip çalar) ve hoparlör kartındaki "Test Et" (örnek anons gönderir).

#### [radio-settings] Telsizde hangi ayarlar önemli?
1. İstasyon telsizi: VOX AÇIK (başlangıç için 9 üzerinden 3–5 hassasiyet), squelch 3–5, pil tasarrufu KAPALI, çift izleme (dual watch) KAPALI, TOT (yayın zaman aşımı) en az 60–120 sn, roger beep isteğe bağlı.
2. El telsizi: VOX kapalı (PTT kullanırsınız), istasyon telsiziyle aynı kanal ve CTCSS/DCS kodu.
3. İstasyon telsizinin ses düğmesi sesinizin Mac'e ne kadar yüksek geleceğini belirler; yaklaşık %50–60 ile başlayın.
4. Bazı telsizler aksesuar kablosu takılıyken VOX'u kapatır veya ayrı bir "aksesuarda VOX" seçeneği ister; telsizin kılavuzuna bakın.

#### [usb-hub] USB ses kartı kopuyor veya cızırdıyor
1. Ses kartını doğrudan Mac'e ya da güç adaptörlü bir hub'a takın; güçsüz hub'lar ve uzun adaptörler kopma ve cızırtı yapar.
2. Uğultu duyuyorsanız Mac'i aynı adaptör üzerinden şarj eden USB-C çoklayıcılardan kaçının.
3. Yeniden takınca walkai-talkai ses motorunu birkaç saniye içinde kendiliğinden yeniden kurar. Dinleme yine de başlamazsa dinlemeyi kapatıp açın (İstasyon sekmesi veya menü çubuğu paneli).

### Sesim algılanmıyor

#### [not-hearing] Telsizden konuşuyorum ama hiçbir şey olmuyor
1. Dinlemenin açık olduğunu kontrol edin: İstasyon sekmesinde Dinleme Aktif yazar, konuşurken spektrum hareket eder ve menü çubuğundaki yıldız yeşil yanıp söner.
2. Ses Ayarları → Giriş Mikrofonu, istasyon telsizinin SP çıkışına bağlı ses kartı olmalı.
3. Mikrofon kartındaki "Test Et" düğmesini kullanın: kayıt sürerken el telsizinden konuşun, sonra kaydı dinleyin. Sessizlik çıkıyorsa ses Mac'e hiç ulaşmıyordur (kablo, giriş, telsiz ses seviyesi).
4. İstasyon telsizinin ses düğmesini açın; sıfıra yakınsa Mac neredeyse hiçbir şey almaz.
5. macOS Sistem Ayarları → Ses → Giriş: ses kartını seçip giriş seviyesini yükseltin; konuşurken seviye göstergesi oynamalı.
6. macOS mikrofon izni: Sistem Ayarları → Gizlilik ve Güvenlik → Mikrofon → walkai-talkai açık olmalı.

#### [voice-isolation] Ses zayıf, kesik kesik veya hiç gelmiyor
1. macOS Mikrofon Modu Ses İzolasyonu'nda olabilir: telsiz sesini arka plan gürültüsü sayıp siler. Denetim Merkezi (menü çubuğu) → Mikrofon Modu → walkai-talkai dinlerken Standart seçin.
2. Mac'iniz Ses ayarlarında gösteriyorsa giriş cihazı için "Ortam gürültüsünü azalt" seçeneğini kapatın.
3. Mikrofonu işleyen diğer uygulamalar (Krisp benzeri gürültü engelleyiciler, sanal ses cihazları) da telsiz sesini bastırabilir.

#### [stops-listening] Çalışıyordu, sonra beni duymamaya başladı (uyku veya cihaz değişimi sonrası)
1. macOS cihazlar değişince (uyku ve uyanma, AirPods/Bluetooth bağlanması, USB yeniden takma) ses motorunu durdurur. walkai-talkai bunu algılar ve dinlemeyi birkaç saniye içinde yeniden kurar.
2. Kendiliğinden düzelmezse dinlemeyi İstasyon sekmesinden veya menü çubuğu panelinden kapatıp açın.
3. Bluetooth kulaklıklar varsayılan giriş/çıkış olabilir; Ses Ayarları'nın hâlâ telsiz ses kartını gösterdiğinden emin olun.

#### [squelch-noise-rx] Sürekli gürültü kaydediyor veya kendi kendine tetikleniyor
1. İstasyon telsizinde squelch'i, kimse yayın yapmazken sessiz kalacak kadar yükseltin; açık squelch konuşma gibi algılanan sürekli hışırtı gönderir.
2. Kanaldaki başka kullanıcılar istasyonunuzu açmasın diye iki telsizde de CTCSS/DCS kodu kullanın.
3. Düşük frekanslı uğultu ve masa vurmaları otomatik elenir, ama sürekli hışırtı elenmez; telsiz tarafında düzeltin.
4. USB mikrofon mu kullanıyorsunuz? Giriş Mikrofonu odadaki her şeyi duyan bir mikrofon değil, telsiz ses kartı olmalı.

#### [other-users] Kanaldaki başka biri komut tetikledi
1. Aynı frekanstaki herkes istasyon telsizi tarafından duyulabilir. Az kullanılan bir kanal ve CTCSS/DCS kodu seçin, istasyon telsizinin gücünü düşük tutun.
2. Ajanınızın geri alınamaz işlemlerden (silme, push, deploy) önce onay istemesini sağlayın. Anonslar ve yapay zeka yanıtları da frekanstaki herkes tarafından duyulur.
3. İstasyonu kullanmadığınızda dinlemeyi duraklatın.

#### [mic-test-silent] Mikrofon testi hiçbir şey çalmıyor
1. Test kaydı macOS'un o anki sistem çıkışından (Ses → Çıkış) çalınır. Sesini açın.
2. Kayıt sessizse giriş ses almıyordur: giriş cihazını, kabloyu ve telsiz ses seviyesini kontrol edin ("Telsizden konuşuyorum ama hiçbir şey olmuyor" maddesine bakın).
3. Mikrofon testi hiçbir zaman Whisper'a veya yapay zekaya gönderilmez.

### Yanlış veya eksik metin

#### [wrong-words] Yanlış kelimeler anlıyor
1. Ayarlar → Konuşma tanıma: Whisper Large v3 Turbo'ya geçin (yaklaşık 1,5 GB indirme). Özellikle İngilizce teknik terimli Türkçede çok daha doğrudur.
2. Ayarlar → Dil konuştuğunuz dille aynı olmalı; konuşma tanıma seçili dili kullanır.
3. El telsizinin mikrofonuna 10–15 cm mesafeden, normal sesle konuşun; bağırmak FM sesini bozar.
4. İstasyon telsizinin sesini, mikrofon testi kaydı net ve patlamasız duyulacak şekilde ayarlayın.

#### [cut-sentence] Komutum yarıda kesiliyor veya ikiye bölünüyor
1. Komut yaklaşık 1,3 saniyelik sessizlikten sonra biter. Cümle ortasında uzun duraklamayın; PTT'yi basılı tutup konuşmaya devam edin.
2. PTT'yi konuşmanız bittikten sonra bırakın.
3. El telsizinizde pil tasarrufu veya yavaş squelch varsa yayının başı kaybolabilir; iki telsizde de pil tasarrufunu kapatın.

#### [first-word-missing] Komutumun ilk kelimesi eksik
1. PTT'ye basın, yarım saniye bekleyin, sonra konuşun. Telsizlerin yayına geçmesi ve squelch'in açılması kısa sürer.
2. İstasyon telsizinde pil tasarrufunu kapatın; tasarruf modunda geç uyanır ve başlangıcı kaçırır.
3. CTCSS/DCS kodunu yalnızca gerekiyorsa kullanın; bazı telsizler tonla açılırken kısa bir gecikme ekler.

#### [hallucination] Kimsenin söylemediği bir komut çıktı
1. Whisper gürültüden metin uydurabilir. walkai-talkai sık görülen uydurma ifadeleri eler ve düşük frekanslı uğultuyu yok sayar, ama sürekli hışırtı yine geçebilir.
2. Squelch'i yükseltin, CTCSS/DCS kullanın ve girişin odadaki bir mikrofon değil telsiz ses kartı olduğundan emin olun.
3. Son Komutlar'a bakın: alınan her komut sesiyle kaydedilir; neyin tetiklediğini dinleyebilirsiniz.

#### [wrong-language] Yanlış dilde yazıyor
1. Konuşma tanıma Ayarlar → Dil'de seçili dili (Türkçe veya İngilizce) kullanır; otomatik algılamaz. Konuştuğunuz dili seçin.
2. Dili değiştirmek API Modu'nda yeni bir yapay zeka oturumu da başlatır; eski bağlam dilleri karıştırmaz.

#### [turbo-download] Large v3 Turbo indirmesi başarısız oluyor veya bitmiyor
1. Yaklaşık 1,5 GB; kararlı bir bağlantı ve en az 2 GB boş disk alanı gerekir.
2. Ayarlar → Konuşma tanıma'dan iptal edip yeniden deneyin. Yarım veya bozuk dosya reddedilir, gömülü Base modeli etkin kalır.
3. Yavaş bağlantıda Whisper Small (yaklaşık 470 MB) iyi bir ara seçenektir.

#### [slow-recognition] Konuşma tanıma çok uzun sürüyor
1. Large v3 Turbo en doğru ama en ağır modeldir. Çok uygulama açık bir M1'de Whisper Small veya Base deneyin.
2. Uzun komutlar daha uzun sürer; komutları kısa ve net tutun.
3. MacBook'ta Düşük Güç Modu konuşma tanımayı yavaşlatır; şarja takın veya kapatın.

### Telsizden anons

#### [no-transmit] Anonslar telsizden gitmiyor
1. Ses Ayarları → Çıkış Hoparlörü, istasyon telsizinin MIC girişine bağlı ses kartı olmalı.
2. Çıkış kanalı: çoğu telsiz kablosu tek tarafı kullanır. Varsayılan Sağ; hiçbir şey gitmiyorsa Sol veya Stereo deneyin.
3. Hoparlör kartındaki "Test Et" düğmesine basıp istasyon telsizine bakın: TX ışığı yanmalı. Yanmıyorsa VOX açılmıyordur (VOX maddelerine bakın) veya kablo yanlış girişte.
4. macOS Ses → Çıkış: ses kartını seçip sesini yüksek (%80–100) yapın. Uygulamanın kendi seviyesi bunun üzerine uygulanır.
5. İstasyon telsizinin menüsünde VOX'un açık olduğundan emin olun.

#### [first-word-cut-tx] Anonsların başı kesiliyor
1. Telsizin VOX'unun yayına geçmesi zaman alır. Ses Ayarları → Gelişmiş Ses Ayarları → VOX Uyandırma Süresini (varsayılan 750 ms, aralık 0–2500 ms) 250 ms adımlarla artırın.
2. Konuşma başlamadan telsiz tamamen yayına geçsin diye konuşma öncesi bekleme (0–1500 ms) ekleyin.
3. Konuşmadan önce bir uyarı sesi seçin (Taktik üçlü ton, Motorola cıvıltısı…): VOX'u açar ve dinleyeni uyarır.
4. Dinleyen el telsizinde pil tasarrufunu kapatın; geç uyanabilir.

#### [end-cut-tx] Anonsların sonu kesiliyor
1. Ses Ayarları → Gelişmiş Ses Ayarları → Anons Sonu Bekleme süresini (0–2000 ms, varsayılan 200 ms) artırın: telsiz son kelimeden sonra biraz daha yayında kalır.
2. Telsiz menüsünde VOX gecikmesini (bırakma süresi) artırın; konuşma bittikten sonra biraz daha yayında kalsın.
3. Her anons roger beep ile biter; hiç duymuyorsanız telsiz son kısmı düşürüyordur.
4. Telsizin TOT (yayın zaman aşımı) ayarını kontrol edin: çok uzun anonslar TOT dolunca kesilir. 60–120 sn veya üzerine ayarlayın.

#### [vox-drops] VOX anons ortasında düşüyor
1. Ses Ayarları → Gelişmiş Ses Ayarları → VOX Tutucu Ses Seviyesini (varsayılan %50) artırın. Kısık bir 82 Hz ton, kelime aralarındaki duraklamalarda VOX'u açık tutar.
2. Telsizin VOX hassasiyetini bir kademe artırın veya VOX gecikmesini uzatın.
3. Çıkış çok kısıksa (anons çıkış seviyesi %20'ye yakın) VOX konuşmayı güvenilir algılamayabilir; yükseltin.

#### [distorted-tx] Anonslar bozuk veya çok yüksek
1. Ses Ayarları → Gelişmiş Ses Ayarları → Anons Çıkış Seviyesini (%20–100, varsayılan %100) düşürün. Telsiz MIC girişi birkaç milivolt bekler; kulaklık çıkışı çok daha güçlüdür.
2. Ses kartının macOS çıkış sesini yaklaşık %50–70'e indirin.
3. Zayıflatıcılı (10–30 dB) bir kablo kullanın veya telsiz menüsünde varsa mikrofon kazancını düşürün.
4. Kablo iki tarafı topluyorsa Stereo yerine Sağ veya Sol kanal seçin.

#### [quiet-tx] Anonslar el telsizinde çok kısık
1. Ses Ayarları → Gelişmiş Ses Ayarları → Anons Çıkış Seviyesini ve ses kartının macOS çıkış sesini artırın.
2. Çıkış kanalını kontrol edin: yanlış taraf seçiliyse telsize yalnızca zayıf bir sızıntı ulaşır.
3. El telsizinin sesini açın; anonsun başladığını duymak için farklı bir konuşma öncesi sesi de deneyin.

#### [tx-own-echo] İstasyon kendi anonsunu duyuyor
1. walkai-talkai yayın sırasında ve sonrasında 1,5 sn boyunca girişi yok sayar; kendi sesi komut sayılmaz.
2. Yine de komut çıkıyorsa istasyon telsizi güçlü bir yankı veya yakındaki başka bir telsizi alıyordur; telsizler arasındaki mesafeyi artırıp gücü düşürün.

#### [ack-beep] Her komuttan sonra kısa bir bip gidiyor
1. Bu teslim bipidir: komutun ajana veya yapay zekaya ulaştığını doğrular. Ayarlar → Komut gönderildiğinde onay sesi çal seçeneğinden kapatabilirsiniz.

#### [announce-language] Anonslar yanlış dilde veya aksanla okunuyor
1. Konuşma dili Ayarlar → Dil'i izler. Türkçe için Türkçe nöral ses, İngilizce için İngilizce ses kullanılır.
2. Ajan, /api/reply'a "lang": "en" veya "tr" göndererek tek bir anons için dili değiştirebilir.

#### [mode-announcements] Mod veya dil değişince telsizden anons yapıyor
1. Ayarlar → Mod ve dil seçimlerinde sesli anons: bu bildirimlerin yayına çıkmasını istemiyorsanız kapatın.

### Seviyeler, sağ/sol, ses

#### [levels-guide] Hangi seviyelerle başlamalıyım?
1. İstasyon telsizi ses düğmesi: yaklaşık %50–60. Ses kartının Mac giriş seviyesi: yaklaşık %50–70.
2. Ses kartının Mac çıkış sesi: %70–100. Uygulamanın anons çıkış seviyesi: %100; anons bozuluyorsa düşürün.
3. Telsiz VOX hassasiyeti: 9 üzerinden 3–5. Uygulamada VOX uyandırma: 750 ms. VOX tutucu ton: %50. Gürültü kapısı: %60.
4. Her seferinde tek bir şeyi değiştirin ve her değişiklikten sonra iki Test düğmesini kullanın.

#### [left-right] Sol, sağ mı stereo mu?
1. Birçok telsiz arayüz kablosu kulaklık fişinin yalnızca bir kanalını telsiz MIC'ine bağlar; diğer kanal PTT veya hoparlör hattına değip sorun çıkarabilir.
2. Sağ (varsayılan) ile başlayın. hoparlör kartındaki Test Et sırasında telsiz yayına geçmiyorsa Sol, sonra Stereo deneyin.
3. Bu ayar uygulama içinde dijital uygulanır, macOS denge kaydırıcısı etkilemez; yine de ortada tutun.

#### [input-clipping] Kaydedilen sesim bozuk (giriş çok yüksek)
1. İstasyon telsizinin ses düğmesini kısın; en sık neden budur.
2. Ses kartının Mac giriş seviyesini düşürün. walkai-talkai da patlama sürerse seviyeyi kademeli olarak kendiliğinden kısar.
3. Normal sesle ve el telsizinin mikrofonuna çok yaklaşmadan konuşun.

#### [input-too-low] Sesim Mac'e çok kısık ulaşıyor
1. İstasyon telsizinin ses düğmesini ve ses kartının Mac giriş seviyesini artırın.
2. Ses kartınızda line/mic anahtarı varsa mic konumunu kullanın (daha fazla kazanç).
3. Uygulama kısık konuşmayı çözümlemeden önce dengeler, ama neredeyse sessiz bir sinyal kurtarılamaz.

#### [system-sounds] Bildirim sesleri veya müzik telsizden gidiyor
1. Telsiz ses kartı macOS'un varsayılan çıkışıysa her uygulama telsizden çalar. Sistem Ayarları → Ses → Çıkış'ta hoparlörünüzü veya kulaklığınızı seçin.
2. walkai-talkai anonsları macOS varsayılanından bağımsız olarak Ses Ayarları'nda seçili cihaza gönderir.
3. Sistem Ayarları → Ses → "Ses efektlerini şuradan çal" seçeneğini de hoparlörlerinize ayarlayın.

#### [sample-rate] Ses robotik, hızlı/yavaş veya cızırtılı
1. Audio MIDI Ayarları'nı açın (Uygulamalar → İzlenceler), ses kartını seçip giriş ve çıkış için 48.000 Hz (veya 44.100 Hz), 2 kanal yapın.
2. Biçimi değiştirdikten sonra dinlemeyi yeniden başlatın.
3. Ucuz ses kartları 96 kHz'te bazen sorun çıkarır; kullanmayın.

### Parazit, uğultu, takılı yayın

#### [tx-stuck] Telsiz yayında takılı kalıyor (VOX takılıyor), parazit geliyor
1. walkai-talkai kapalıyken deneyin. Telsiz yine yayına geçiyorsa neden donanım yolundadır: ses kartı çıkışındaki gürültü veya uğultu VOX'u açıyordur.
2. Kabloyu ses kartından çekin: yayın kesiliyorsa sebep ses hattıdır. Telsizin VOX hassasiyetini düşürün, macOS çıkış sesini kısın veya toprak izolatörü takın.
3. Telsiz ses kartının macOS varsayılan çıkışı olmadığından emin olun (bildirimler ve başka uygulamalar telsizi yayına geçirir).
4. Uygulamadaki VOX Tutucu Ses Seviyesini düşürün; telsiziniz onsuz VOX'u tutuyorsa %0 yapın.
5. Kablo çekiliyken bile yayın sürüyorsa telsizin PTT/VOX'u takılıdır: telsizi kapatıp açın.
6. Uygulama içinde yayın her zaman bir zaman aşımından sonra zorla bitirilir; uygulama telsizi sonsuza dek yayında tutamaz.

#### [ground-loop] Sürekli bir uğultu veya vızıltı var
1. Klasik toprak döngüsü: şarjdaki Mac + USB ses kartı + kendi şarjında telsiz. Mac'i pille çalıştırmayı deneyin; uğultu kayboluyorsa Mac ile telsiz arasındaki hatta toprak izolatörü (ses izolasyon trafosu) kullanın.
2. Telsiz şarj cihazını Mac'le aynı uzatmaya takın.
3. Kısa, ekranlı kablolar kullanın ve güç adaptörlerinden uzak tutun.

#### [rf-feedback] Yalnızca yayın sırasında ıslık veya bozuk ses (RF geri besleme)
1. İstasyon telsizinin anteni kabloya veya Mac'e çok yakın ve yaydığı RF ses hattına karışıyor.
2. Telsizi Mac'ten uzaklaştırın (veya harici anten kullanın), yayın gücünü düşürün ve ses kablosunun iki ucuna da ferrit halka takın.

#### [hold-tone-audible] Anonsların altında kalın bir uğultu duyuyorum
1. Bu, duraklamalarda telsizi yayında tutan VOX tutucu tondur (82 Hz). Ses Ayarları → Gelişmiş Ses Ayarları → VOX Tutucu Ses Seviyesini düşürün veya VOX onsuz açık kalıyorsa %0 yapın.
2. Bazı telsizler CTCSS ayarlarıyla bunu süzer, bazıları geçirir. VOX'u açık tutan en düşük seviyeyi bulun.

#### [tone-after] Anons bittikten sonra sabit bir ses devam ediyor
1. Bu, roger bipine kadar çalan VOX tutucu tondur. Ses Ayarları → Gelişmiş Ses Ayarları → Anons Sonu Bekleme süresini düşürün (varsayılan 200 ms).
2. Ses roger bipinden sonra da sürüyorsa walkai-talkai'den değil telsizden veya kablodan geliyordur: "Telsiz yayında takılı kalıyor" maddesine bakın.

#### [hiss-gaps] Kelime aralarında hışırtı duyuluyor
1. Ses Ayarları → Gelişmiş Ses Ayarları → Gürültü Kapısını (%0–100, varsayılan %60) artırın. Kelime aralarındaki arka plan sesini susturur.
2. Kapı çok yüksekse sessiz kelime sonlarını kırpabilir; konuşma kesik geliyorsa biraz düşürün.

#### [static-bursts] Rastgele çıt, patlama veya cızırtı
1. Kabloyu ve fişi kontrol edin: gevşek bir K-fiş veya kırık kablo dokununca cızırdar.
2. USB güç sorunları patlama yapar; başka bir USB portu veya güçlü bir hub deneyin.
3. Kablonun yanındaki Wi-Fi/Bluetooth adaptörleri ve telefonlar vızıltı patlamaları yapabilir; uzaklaştırın.

### Hedef Pencere ve ajanlar

#### [paste-not-working] Komutlar ajanıma yazılmıyor (Hedef Pencere modu)
1. Erişilebilirlik izni verin: Sistem Ayarları → Gizlilik ve Güvenlik → Erişilebilirlik → walkai-talkai açık. Menü çubuğu simgesindeki kırmızı nokta iznin eksik olduğunu gösterir.
2. Güncellemeden sonra macOS bazen iznin yeniden verilmesini ister: walkai-talkai'yi listeden kaldırıp tekrar ekleyin.
3. Hedefi yeniden seçin: menü çubuğu paneli → Hedef seç (veya simgeye sağ tık → Hedef Input Seç), sonra ajanın giriş kutusuna tıklayın.
4. Bazı uygulamalar güvenli alanlarda (şifre kutuları) veya Terminal'de "Güvenli Klavye Girişi" açıkken taklit yazmayı engeller; kapatın.

#### [wrong-window] Yanlış pencereye veya yere yazıyor
1. Hedef, seçili uygulama penceresine göre ekrandaki bir noktadır. Pencereyi taşıdıysanız veya boyutlandırdıysanız hedefi yeniden seçin.
2. Hedef uygulamayı açık (küçültülmemiş) ve aynı masaüstü alanında tutun.

#### [agent-silent] Ajanım çalışıyor ama telsizden hiç cevap vermiyor
1. Ajanın telsiz protokolünü bilmesi gerekir. Hedef Pencere sekmesinde "Hedefe Gönder" ile başlangıç promptunu her oturumda bir kez ajana yapıştırın.
2. Prompt ajana http://127.0.0.1:1988/api/reply adresine POST yapmasını söyler. Ağ veya komut satırı erişimini engelleyen ajanlara (sandbox, izin soruları) curl çalıştırma izni verilmelidir.
3. Eski promptlarda port 8765 kalmış olabilir; walkai-talkai kayıtlı promptları 1988'e taşır, ama ajan sohbetine daha önce yapıştırılmış promptun orada güncellenmesi gerekir.
4. Kendiniz deneyin: curl -s -X POST http://127.0.0.1:1988/api/reply -H "Content-Type: application/json" -d '{"text":"Test, tamam."}'

#### [agent-talks-too-much] Ajan telsizden uzun metin veya kod okuyor
1. Başlangıç promptunu (Hedef Pencere sekmesi) düzenleyip vurgulayın: en fazla 2–4 kısa cümle, asla kod okuma, "tamam" ile bitir. Ajana yeniden gönderin.
2. API Modu'nda API Ayarları'ndaki başlangıç promptunu aynı şekilde düzenleyin.

### API Modu (yapay zeka sağlayıcıları)

#### [api-401] API Modu API anahtarının geçersiz olduğunu söylüyor (401)
1. API Ayarları → profili düzenleyip anahtarı boşluksuz yeniden yapıştırın. OpenAI, Anthropic, Gemini ve DeepSeek anahtarları farklıdır; her biri kendi anahtarını ister.
2. Anahtarın etkin olduğunu ve sağlayıcıda faturalandırmanın açık olduğunu kontrol edin.

#### [api-429] API Modu kota veya istek sınırının aşıldığını söylüyor (429)
1. Sağlayıcı hesabınız istek veya harcama sınırına ulaştı. Bir dakika bekleyin, faturalandırmayı kontrol edin veya başka bir profile geçin.

#### [api-404] API Modu modelin bulunamadığını söylüyor (404)
1. Model adı yanlış veya kullanımdan kalkmış. Profili düzenleyip yenilenen model listesinden bir model seçin.

#### [api-timeout] API Modu zaman aşımına uğruyor veya sunucuya ulaşamıyor
1. İnternet bağlantısını kontrol edin; API Modu internet ister (konuşma tanıma ve ses istemez).
2. Şirket ağları ve VPN'ler yapay zeka sağlayıcılarını engelleyebilir; başka bir ağ deneyin.
3. Özel uç noktada adresi kontrol edin (OpenAI uyumlu sunucularda /v1 ile bitmeli).

#### [ollama] Ollama (yerel) cevap vermiyor
1. Ollama'yı başlatın ve bir model indirildiğinden emin olun (örneğin "ollama pull llama3.1").
2. Uç nokta http://localhost:11434/v1. "ollama list" çıktısındaki model adını aynen seçin.
3. Büyük yerel modeller küçük Mac'lerde yavaştır; anons tam yanıtı bekler.

#### [api-context] Yapay zeka konuştuklarımızı unutuyor
1. Her profil ve modelin kendi oturumları vardır. Profil/model veya dil değişince farklı bir oturum başlar ya da devam eder.
2. Oturumu API Ayarları → Sohbet oturumu'ndan seçin veya bağlamı açık tutun.

### Yerel API (port 1988)

#### [localapi-refused] 127.0.0.1:1988'e curl başarısız (bağlantı reddedildi)
1. walkai-talkai çalışıyor olmalı. API yalnızca 127.0.0.1'de dinler (ağınızda değil).
2. Port 1988'i başka bir uygulama kullanıyor olabilir: hangisi olduğunu görmek için Terminal'de "lsof -nP -iTCP:1988 -sTCP:LISTEN" çalıştırın.
3. Eski promptlar veya betikler hâlâ 8765 kullanıyor olabilir; 1988 olarak güncelleyin.

#### [localapi-403] /api/reply 403 döndürüyor
1. Lisans etkin değil. Hakkında → Lisans'tan etkinleştirin; API üzerinden anons için etkin lisans gerekir.

#### [localapi-json] /api/reply 400 döndürüyor (geçersiz JSON)
1. {"text": "..."} biçiminde JSON gövdesini Content-Type: application/json; charset=utf-8 ile gönderin.
2. Metin içindeki tırnakları kaçış karakteriyle yazın ve kabuğun UTF-8 karakterleri bozmadığından emin olun (zsh/bash'te JSON'u tek tırnak içine alın).

### Lisans ve satın alma

#### [license-activate] Lisansım etkinleşmiyor
1. Anahtarı e-postadaki gibi aynen kopyalayın (WALKAI-XXXX-XXXX-XXXX). Büyük/küçük harf fark etmez.
2. Etkinleştirme bir kez internet ister. Bağlantınızı ve güvenlik duvarını kontrol edin.
3. Lisans aynı anda tek bir Mac'te çalışır. Başka bir Mac'te etkinse orada kaldırın (Hakkında → Lisans → Bu Mac'ten Kaldır) ve yeniden etkinleştirin.
4. Eski Mac artık yoksa etkinleştirmeyi sıfırlamak için satın alma e-postanızla destekle iletişime geçin (walkai-talkai.com/tr/lisans).
5. Uygulamaya yeniden mi ihtiyacınız var? walkai-talkai.com/tr/lisans adresinden anahtarınızla indirin.

#### [license-lost] Lisans anahtarımı kaybettim
1. Uygulama olmadan: walkai-talkai.com/tr/lisans adresine gidip satın alma e-postanızı girin; anahtarı indirme bağlantısıyla birlikte e-postayla gönderelim.
2. Uygulamada: aktivasyon penceresi veya Hakkında → Lisans → "Anahtarımı kaybettim", sonra satın alma e-postanızı girin.
3. Spam klasörüne bakın. İstekler sınırlıdır; tekrar denemeden önce birkaç dakika bekleyin.

#### [license-offline] Çevrimdışı kaldıktan sonra uygulama yeniden lisans istiyor
1. Lisans ara sıra çevrimiçi yeniden doğrulanır; doğrulamalar arasında uygulama 14 güne kadar çevrimdışı çalışır. Hakkında → Lisans son doğrulamayı ve kalan günü gösterir.
2. İnternete bağlanıp uygulamayı açın; doğrulama kendiliğinden yapılır.

#### [license-move] Lisansımı yeni Mac'e nasıl taşırım?
1. Eski Mac'te: Hakkında → Lisans → Bu Mac'ten Kaldır. Yeni Mac'te: aynı anahtarı girin.

### Uygulama, macOS ve güncellemeler

#### [menu-bar] Menü çubuğundaki kontroller nerede?
1. Paneli açmak için menü çubuğu simgesine sol tıklayın: durum, mod, son komut, hedef seç, test yayını, giriş cihazı, dil, ayarlar ve çıkış.
2. Klasik menü için simgeye sağ tıklayın (veya Control ile tıklayın).
3. Simgedeki yıldız alırken yeşil, yayın yaparken turuncu yanıp söner. Kırmızı nokta Erişilebilirlik izninin eksik olduğunu gösterir.

#### [mic-permission] macOS mikrofon izni istiyor veya dinleme hiçbir şey yapmıyor
1. Sistem Ayarları → Gizlilik ve Güvenlik → Mikrofon → walkai-talkai'yi açın, sonra dinlemeyi yeniden başlatın.
2. walkai-talkai listede yoksa uygulamadan çıkıp yeniden açın; macOS izni tekrar sorar.

#### [updates] Nasıl güncellerim? Güncelleme görünmüyor
1. Hakkında → Güncellemeleri Denetle. Güncellemeler imzalı ve noterlidir, uygulama içinden gelir.
2. Güncelleme çıkmıyorsa zaten en son sürümdesiniz; Hakkında sekmesi sürümünüzü gösterir.

#### [crash-report] macOS walkai-talkai'nin beklenmedik şekilde kapandığını söylüyor
1. En son sürüme güncelleyin (Hakkında → Güncellemeleri Denetle); çıkışta oluşan bir çökme düzeltildi.
2. Sürüyorsa rapor metnini desteğe gönderin (macOS penceresindeki "Rapor Et…" düğmesi gösterir).

#### [auto-start] Açılır açılmaz dinlemeye başlıyor
1. İstasyon hazır olsun diye dinleme varsayılan olarak açıktır. Gerekmediğinde İstasyon sekmesinden veya menü çubuğu panelinden duraklatın.
2. Giriş odadaki bir mikrofonsa açılıştaki sesler konuşma sanılabilir; giriş olarak telsiz ses kartını kullanın.

#### [legal] Telsizimi bu şekilde kullanmak yasal mı?
1. Frekanslar, yayın gücü, lisans ve otomatik ya da gözetimsiz yayınla ilgili kurallar ülkeye ve banda göre değişir (PMR446, FRS, GMRS, amatör telsiz…).
2. Yerel kurallara uymak sizin sorumluluğunuzdadır. Anonsların frekanstaki herkes tarafından duyulabileceğini unutmayın.