Troubleshooting

A publisher warning appears during installation

Beta builds are pre-code-signing, so a SmartScreen/Defender warning is shown normally. Follow the “First launch guide” on the download page to allow it just once, and it won’t show afterward. The installer is large, so the first scan may take a while — if a window doesn’t appear right away, wait a moment and try running it again.

---

VNC remote screen

How to connect

New tab menu → VNC connect… or a saved connection. Input fields:

Field	Default	Description
Host	—	VNC server IP or domain
Port	5900	VNC default port
Password	—	VNC authentication password
Save name	—	If entered, registers in saved connections

Reaching an internal-network VNC via SSH tunnel

Enabling the SSH tunnel option in the connection dialog lets you reach an internal-network VNC through a bastion server. You don’t need to open port 5900 directly from outside the firewall.

Header buttons

Button	Action
Send clipboard	Send the local clipboard to the remote
Ctrl+Alt+Del	Send Ctrl+Alt+Del to the remote PC
📁 FT	Toggle the file transfer panel

Clipboard shortcuts

• Ctrl+Shift+V — Send the local clipboard to the remote only (no paste key sent)
• Ctrl+V — Send + also send the paste key to the remote

File transfer (TightVNC 2.x FT)

Caution

File transfer works only on TightVNC 2.x servers. UltraVNC and older TightVNC have a different wire format and are not supported.

File transfer panel features:

Feature	Method
Browse folders	Click an item in the list, ↑ for parent folder
Refresh	↻ button
New folder	➕ button
Upload	⬆ button (multiple files can be selected)
Download	Double-click / right-click / check boxes then download
Rename / delete	Right-click menu

Uploading a file with the same name shows an overwrite confirmation message.

If filenames are garbled, change the encoding dropdown at the top of the panel (default UTF-8). Changing it auto-reconnects.

VNC troubleshooting

Symptom	Cause	Action
Connection fails	Wrong host / port / password	Recheck connection details, confirm VNC is running on the server
Can’t reach internal network	Firewall blocking	Enable the SSH tunnel option
File transfer panel missing or errors	Server isn’t TightVNC 2.x	Switch to a TightVNC 2.x server
Garbled filenames	Server encoding mismatch	Select the server encoding in the encoding dropdown (e.g. EUC-KR)
Screen shows but clipboard doesn’t work	Server clipboard disabled	Enable clipboard sharing in VNC server settings

---

WinRM — remote Windows PowerShell

Note

WinRM is supported only when running Blyck on Windows.

How to connect

New tab menu → WinRM (remote Windows)…. Input fields:

Field	Default	Description
Host	—	Remote Windows PC IP or domain
User	—	Windows local or domain account
Password	—	Account password
Port	5985 (HTTP) / 5986 (HTTPS)	Selected via the HTTPS toggle
Use HTTPS	Off	On for 5986, off for 5985
Save name	—	If entered, registers in saved connections

Remote PC prerequisites

On the remote PC, open PowerShell as administrator and run:

Enable-PSRemoting -Force

For workgroup or direct-IP connections (not a domain environment), you must set TrustedHosts on the client PC. Clicking the “Add this host to trusted” button in the connection dialog handles it automatically.

To set it manually:

# Run in administrator PowerShell
Set-Item WSMan:\localhost\Client\TrustedHosts -Value "target IP or hostname" -Force

How it works and limitations

• Type a PowerShell command in the console and press Enter to run.
• Browse command history with the ↑ / ↓ keys.
• It’s an imperative approach that makes a new connection per command (session state is not preserved).
• Interactive prompts like Read-Host are not supported.

WinRM troubleshooting

Symptom	Cause	Action
”Access denied” error	Insufficient account permissions	Use an administrator account or add to the remote-management allowed group
Won’t connect (workgroup)	TrustedHosts not set	Click “Add this host to trusted” in the dialog
Won’t connect (firewall)	Port 5985/5986 blocked	Allow WinRM ports in the remote PC firewall
No WinRM service	PSRemoting not enabled	Run Enable-PSRemoting -Force on the remote PC
HTTPS certificate error	Self-signed certificate	Connect over HTTP (5985) or set up certificate trust
No WinRM in the menu	Running on macOS	Windows-only feature, use it on a Windows PC

---

Desktop capture

Screen-region capture (📷)

Clicking the 📷 button in the tab bar covers the screen with a transparent overlay.

1. Drag with the mouse to select the region to capture (external monitors included).
2. The captured image opens in the markup editor — annotate with arrows, text, and a highlighter.
3. Clicking the “Send to AI” button attaches the image to the open AI Chat.

Tip

The AI Chat panel must be open for the “Send to AI” button to be active.

Desktop mirror (live streaming)

New tab menu → 🖥️ Desktop capture… → select an app from the window list, and that window is live-streamed into the panel (view-only).

• The AI can see the mirrored screen with the panel_screenshot tool.
• The web preview panel can be captured and sent to the AI with the ✏️ button.

---

Full troubleshooting

App crashes · white screen

Symptom	Cause	Action
Screen goes white and auto-reloads	Renderer process crash	Auto-recovered — normal behavior
Crashes 3+ times within 30 seconds	GPU driver or memory issue	Update the GPU driver and relaunch
Stays white even after reload	Serious renderer error	Check crash.log and contact support

Crash log location: %APPDATA%\Blyck\crash.log

When a crash occurs:

1. Open crash.log and check the last error.
2. Open the developer tools with F12 and check the error in the Console tab.
3. If unresolved, attach crash.log and logs\blyck.log on the contact page.

Freezes · keystroke lag

Symptom	Cause	Action
Freezes 5–10s then auto-recovers	Main thread blocked during RAG re-indexing or LSP init	Wait a moment
Freezes repeatedly	Resource contention	Attach blyck.log and contact support
Long freeze during AI work	Turn backstop (60 min) or 2-minute no-response handling	Force-stop with the ■ Stop button

Updates

Blyck checks for updates at app start and every 4 hours from update.blyck.dev. New versions download in the background and install automatically on app exit.

Symptom	Cause	Action
Update doesn’t apply	App didn’t fully exit	Fully exit including the tray icon, then relaunch
Download fails	Corporate network blocks the CDN	Ask IT to allow update.blyck.dev, or install manually
Update check doesn’t run	Offline environment	Connect to the internet and restart

License

Symptom	Cause	Action
Full-screen lock displayed	14-day trial ended	Paste the license key to authenticate
”Your subscription has expired”	Subscription expired or canceled	Check subscription status in the Lemon Squeezy portal
Authentication fails	Offline	Connect to the network and retry
”Registered on another device”	Device registration exceeded	Manage devices in the Lemon Squeezy portal
Locked after 7 days from authentication	Offline grace period exceeded	Connect to the internet and restart the app to re-verify

Note

An authenticated device can be used for 7 days offline without re-verification.

DB connections

Symptom	Cause	Action
Connection timeout	Network / firewall blocking	Check host, port, and firewall rules. PG/MySQL 10s, MSSQL 15s
Oracle ORA-xxxxx	Server-side error (service name, account lock, etc.)	Recheck server connection details
Oracle NJS-116	Environment unsupported by Thin mode	Check Force Thick + set the 64-bit Instant Client path
Oracle NJS-118	Thick initialization error	Restart the app and retry
MySQL BIGINT shown as string	Precision protection beyond 2^53	Normal behavior — not a bug
Connection pool session surge	—	Auto-managed by the pool (max 4), no problem

For detailed DB issues, see the DB Client page.

Web preview

Symptom	Cause	Action
Page won’t load	Dev server not running	Run the local dev server first, then enter the URL
preview_eval fails immediately	Page still loading	Retry after the preview_wait tool
Stays on a blank screen	URL error or server error	Check the URL and server status

Caution

Web preview requires you to run the dev server first, then enter the URL. It won’t work without a server.

For details, see the Run & Preview page.

RAG search

Symptom	Cause	Action
No results, or old files shown	Index not refreshed	Chat settings → check RAG Index Status
A deleted file is searched	Orphan item	Run the Orphan Scan cleanup tool
Too much noise in results	Unnecessary files indexed	Add exclusion patterns with .termeditignore
Strange results after changing the embedding model	Re-indexing in progress	Wait until re-indexing completes

For RAG index management, see the RAG Search page.

SSH connections

Symptom	Cause	Action
Stuck at password entry	Non-standard prompt (detection wait up to 30s)	Enter directly or use saved passwords
Auto-reconnect fails	Password-only server (password not reused on reconnect)	Set up key/agent auth or reconnect manually
Only SFTP fails	SFTP subsystem disabled	Reconnect manually from the file panel
Garbled Korean	Server locale	Check *.UTF-8 with the server locale

For details, see the Terminal · SSH · SFTP page.

AI features

Symptom	Cause	Action
AI Chat disabled	CLI not installed or not logged in	Install/log in to the CLI in the readiness wizard
401/403 error	API key expired or invalid	Re-register the key or re-run claude login
No response / stuck	Network or expired authentication	After 3 auto-retries, re-login and start a new chat
File changed without an approval card	🚀 Auto mode enabled	Switch to ⚡ Act + Review mode with Ctrl+3

For details, see the AI Chat page.

LSP autocompletion

Symptom	Cause	Action
Python autocompletion doesn’t work	Pyright not installed	Approve the “Download?” modal when first opening a Python file
Go autocompletion doesn’t work	No Go toolchain	After installing Go, run go install golang.org/x/tools/gopls@latest
Rust autocompletion doesn’t work	rust-analyzer download failed	Restart the app in a GitHub-accessible environment, or install manually and register on PATH
Download fails on a corporate network	GitHub blocked	Install the server directly and register it on PATH

Terminal display

Symptom	Cause	Action
Blurry text	WebGL fallback (Canvas/DOM)	Explicitly specify the Canvas renderer in settings
Full-width character alignment broken	Using the DOM renderer	Specify the Canvas renderer in settings
Garbled Korean (local)	—	Windows auto-applies UTF-8; replace native exes like ipconfig with PowerShell cmdlets

---

I want to revert a wrong change

Open the change history with Ctrl+Shift+H and file, DB, and SSH changes are all recorded. Select an item and revert it. DML is automatically backed up just before execution, so even UPDATE without WHERE can be restored.

For detailed behavior, see the Git · ChangeSet page.

---

Log/data locations (Windows)

Item	Location
App log	%APPDATA%\Blyck\logs\blyck.log (2MB rotation)
Crash log	%APPDATA%\Blyck\crash.log
Connection info (excluding passwords)	%APPDATA%\Blyck\connections.json
Layout (tabs · splits)	%APPDATA%\Blyck\layout.json
AI chat history	%APPDATA%\Blyck\chats\
Change history (ChangeSet)	%APPDATA%\Blyck\blyck-history.db
RAG index	Per-workspace SQLite file

Passwords and tokens are stored encrypted in the OS credential store, not in files. In logs, passwords, tokens, API keys, and user paths are automatically masked, and logs are stored locally only and never sent externally.

Tip

Attaching %APPDATA%\Blyck\logs\blyck.log when contacting support speeds up diagnosis.

---

Other issues

For unresolved issues, send them via the contact page. Including environment info (OS · version) and reproduction steps helps us assist quickly. The auxiliary servers Blyck opens internally (MCP · VNC proxy, etc.) all open only with a localhost dynamic port + token authentication, so no firewall exception or port opening is needed.