Skip to main content

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:
ServerLocationURL
FIN1Finland (Hetzner)https://fin1-strm.incrypto.ru
RU1Russiahttps://ru1-strm.incrypto.ru
CustomUser-definedAny 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:
1

Open Settings

Click the gear icon or press Ctrl + ,.
2

Select Custom Server

In the Server section, select “Custom” and enter the full URL (e.g., https://my-server.example.com).
3

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.
LanguageStatus
EnglishFull support
RussianFull support
Switch language in Settings > Appearance > Language. The change takes effect immediately without restarting.

Theme

ThemeDescription
DarkDark background, light text. Optimized for extended screen time.
LightLight 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.
SettingDescriptionOptions
Default chart typeChart type for new tabsCandlestick, Cluster, TPO, Heatmap
Default timeframeInitial timeframe1m, 5m, 15m, 1h, 4h, 1D, 1W, 1M
Default symbolInitial symbolAny available symbol (e.g., BTCUSDT)
Candle colorsBullish / bearish candle colorsColor 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.
SettingDescription
Progressive loadingLoad volume/cluster data in chunks with a progress bar. Keeps the UI responsive for large date ranges.
History depthHow 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.
SettingDescription
Persistent cacheStore fetched data locally in IndexedDB so charts load instantly on next open
Cache sizeDisplays the current number of entries and estimated size in MB
Clear cacheRemoves 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.
SettingDescription
Enable TelegramToggle Telegram notification delivery
Bot tokenToken from @BotFather
Chat IDTelegram chat or channel ID (e.g., -1001234567890)
Test connectionSend a test message to verify the setup

Notification Filters

Choose which events are forwarded to Telegram:
FilterDescription
Price alertsAlerts triggered by drawing tool price levels
Indicator alertsNotifications from indicator alert rules
Calendar alertsEconomic 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.
SettingDescription
Enable calendarToggle the economic calendar feature
Show on chartDisplay event markers on the time axis
Minimum impactFilter events by importance: High, Medium, or Low
CountriesFilter by country or currency (e.g., USD, EUR)
Alert minutes beforeHow many minutes before an event to trigger a notification (0—60)
JBlanked API keyOptional 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.
SettingDescription
Alert soundsEnable or disable sound when price/indicator alerts trigger
Sound volumeMaster 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.
FieldDescription
License keyYour active license key (CT-XXXX-XXXX-XXXX-XXXX format)
StatusActive, Trial, or Expired
FeaturesEnabled features (e.g., cloud_sync, priority_support)
DevicesNumber of activated devices out of maximum allowed
ExpiryLicense 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

1

Obtain a license key

Purchase a license or receive one from the project administrator. Keys are in the format CT-XXXX-XXXX-XXXX-XXXX.
2

Enter the key

Go to Settings > License and paste your key into the license field.
3

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.