Settings
The Settings panel lets you configure every aspect of Cluster Terminal — from the server connection and visual theme to chart defaults, data loading behavior, and sound preferences.
Open Settings from the gear icon in the header bar, or press Ctrl + ,.
Server Connection
Cluster Terminal connects to a data server for all market data (candles, clusters, open interest) and real-time WebSocket streaming.
Quick Server Switch
The fastest way to switch servers is the server indicator in the header bar. Click the connection status label to open the server selector dropdown:
| Server | Location | URL |
|---|
| FIN1 | Finland (Hetzner) | https://fin1-strm.incrypto.ru |
| RU1 | Russia | https://ru1-strm.incrypto.ru |
| Custom | User-defined | Any URL |
Selecting a server instantly reconnects both REST and WebSocket connections. All open charts reload data from the new server. The selected server persists across app restarts.
Choose the server closest to your location for lowest latency. Both FIN1 and RU1 maintain identical data — switching servers does not affect your history or analysis.
Manual Server URL
For advanced setups (self-hosted servers, custom ports), use the Settings panel:
Open Settings
Click the gear icon or press Ctrl + ,.
Select Custom Server
In the Server section, select “Custom” and enter the full URL (e.g., https://my-server.example.com).
Test Connection
The application automatically tests the connection when you save. A green checkmark indicates success; a red icon indicates the server is unreachable.
Changing the server disconnects all active WebSocket streams and reloads chart data from the new server.
Appearance
Language
Cluster Terminal supports multiple interface languages.
| Language | Status |
|---|
| English | Full support |
| Russian | Full support |
Switch language in Settings > Appearance > Language. The change takes effect immediately without restarting.
Theme
| Theme | Description |
|---|
| Dark | Dark background, light text. Optimized for extended screen time. |
| Light | Light background, dark text. |
Dark theme is recommended for trading to reduce eye strain during long sessions, especially with multiple monitors.
Chart Defaults
These settings control the initial configuration when you create a new chart tab.
| Setting | Description | Options |
|---|
| Default chart type | Chart type for new tabs | Candlestick, Cluster, TPO, Heatmap |
| Default timeframe | Initial timeframe | 1m, 5m, 15m, 1h, 4h, 1D, 1W, 1M |
| Default symbol | Initial symbol | Any available symbol (e.g., BTCUSDT) |
| Candle colors | Bullish / bearish candle colors | Color picker |
These defaults only apply to newly created tabs. Existing tabs retain their own settings.
Data Loading
Control how historical data is fetched and cached.
| Setting | Description |
|---|
| Progressive loading | Load volume/cluster data in chunks with a progress bar. Keeps the UI responsive for large date ranges. |
| History depth | How far back to load data on chart open. Deeper history means longer initial load times. |
Progressive Loading
When enabled, large data requests (especially cluster volumes) are split into daily chunks and loaded sequentially. A progress bar in the chart toolbar shows loading status.
Keep progressive loading enabled. It prevents the UI from freezing when loading months of cluster data, especially for high-volume symbols like BTCUSDT.
Cache
Manage local data caching to speed up chart loading.
| Setting | Description |
|---|
| Persistent cache | Store fetched data locally in IndexedDB so charts load instantly on next open |
| Cache size | Displays the current number of entries and estimated size in MB |
| Clear cache | Removes all cached data (clusters, volumes, heatmap, OI, archives) from memory and IndexedDB |
When persistent cache is enabled, historical data that has already been fetched is stored locally. The next time you open a chart for the same symbol and timeframe, data loads from the cache instead of fetching from the server.
If charts show stale or incorrect data, clear the cache and reload. This forces a fresh fetch from the server.
Telegram Notifications
Send alert notifications directly to a Telegram chat or channel via a bot.
| Setting | Description |
|---|
| Enable Telegram | Toggle Telegram notification delivery |
| Bot token | Token from @BotFather |
| Chat ID | Telegram chat or channel ID (e.g., -1001234567890) |
| Test connection | Send a test message to verify the setup |
Notification Filters
Choose which events are forwarded to Telegram:
| Filter | Description |
|---|
| Price alerts | Alerts triggered by drawing tool price levels |
| Indicator alerts | Notifications from indicator alert rules |
| Calendar alerts | Economic calendar event reminders |
The bot must be added to the target chat/channel and have permission to send messages. Use @userinfobot to find your chat ID.
Economic Calendar
Display upcoming macroeconomic events on the chart and receive pre-event notifications.
| Setting | Description |
|---|
| Enable calendar | Toggle the economic calendar feature |
| Show on chart | Display event markers on the time axis |
| Minimum impact | Filter events by importance: High, Medium, or Low |
| Countries | Filter by country or currency (e.g., USD, EUR) |
| Alert minutes before | How many minutes before an event to trigger a notification (0—60) |
| JBlanked API key | Optional API key for accessing past and future week data |
The current week’s events are fetched from ForexFactory (free, no key required). To browse past or upcoming weeks, enter a JBlanked API key.
Set “Minimum impact” to High if you only want to see major events like FOMC, NFP, and CPI releases.
Sound Settings
Configure audio notifications for alerts and system events.
| Setting | Description |
|---|
| Alert sounds | Enable or disable sound when price/indicator alerts trigger |
| Sound volume | Master volume for all notification sounds |
Alert sounds are synthesized in-browser — no external audio files are needed. Each alert type has a distinct sound pattern to help you distinguish between price alerts, indicator signals, and system notifications without looking at the screen.
License
View and manage your license status.
| Field | Description |
|---|
| License key | Your active license key (CT-XXXX-XXXX-XXXX-XXXX format) |
| Status | Active, Trial, or Expired |
| Features | Enabled features (e.g., cloud_sync, priority_support) |
| Devices | Number of activated devices out of maximum allowed |
| Expiry | License expiration date |
Trial Mode
If you have not entered a license key, Cluster Terminal runs in trial mode for 7 days with full functionality. After the trial expires, you need a license key to continue using the application.
Trial duration may vary. The server administrator can configure the trial period via the admin panel.
Activating a License
Obtain a license key
Purchase a license or receive one from the project administrator. Keys are in the format CT-XXXX-XXXX-XXXX-XXXX.
Enter the key
Go to Settings > License and paste your key into the license field.
Activate
Click Activate. The application validates the key with the server and registers your device.
Each license has a maximum device limit. If you reach the limit, deactivate an existing device from the server admin panel or contact support.
Resetting Settings
To reset all settings to defaults, clear the application data directory. On Windows, this is located at:
%APPDATA%/com.cluster-terminal/
Resetting application data removes all local workspaces, license activation, trial state, and cached data. This cannot be undone.