Repository navigation
specola v0.2.3-beta
This beta focuses on first-run guidance, profile management and a more reliable desktop client. Core now checks GitHub for new releases, and a profile can keep TUN and eBPF settings side by side.
Profile format
[enhanced-mode.tun]and[enhanced-mode.ebpf]can be written as standard tables as well as inline tables.- A profile can keep both
tunandebpfsettings.backendselects which one is used, so switching backend no longer discards the other configuration. Profiles saved by Specola now keep both tables.
Existing 0.2.2 profiles load without changes.
Updates
- Core checks the latest stable GitHub release at startup and every hour, and notifies the desktop client when a newer version is available. Beta prereleases are not reported yet.
- The update dialog links to the release page. In-app downloads are not available yet.
Desktop interface
- Title bar: a unified title bar with window controls and an update indicator, and the Core offline overlay now fits the same layout.
- Profiles: redesigned page with Local and From URL groups, drag-and-drop import of
.tomlfiles, an import button, and actions to rename, remove, open in the editor or show in the folder. - First-run guidance: Connections, Proxies, Groups, Rules and DNS show an explanation and actions to add a profile when none is active, instead of an empty list.
- Overview: startup, error and no-profile notices appear inside the status card, so the page no longer shifts between states. The four bottom stats (connections, total traffic, Core memory, uptime) have equal fixed widths. Top traffic rows update in place instead of being rebuilt on every refresh. When only the system proxy is on, the page explains that per-app grouping needs Enhanced mode.
- Groups: loading and error states with Retry, filtering by group or member node, and guidance for profiles without proxy groups.
- Rules: rules whose target needs Enhanced mode and Rule mode say so.
- System tray: the popup shows Core connection state, the current route mode, System proxy and Enhanced mode, and guidance when no profile is active.
- Servers: reorganized server list with CPU, memory and disk metrics.
- SSH deployment: redesigned as a guided workflow: choose SSH servers, check access and OS, pick a protocol preset, and follow progress and logs while the engine is installed as a system service.
Fixes
- The last active profile is activated again after the desktop client starts Core.
- Background Overview refreshes no longer interfere with Core commands such as loading a profile, and a busy Core is no longer reported as disconnected.
- Changing a selection no longer triggers a full data refresh on list pages.
- Quitting from the tray, or with Ctrl+C in a console on Windows, closes the window and tray popup cleanly.
- Windows packages keep the Qt components needed by the Core overlay and the tray icon.
Getting started and limitations
- This is a beta prerelease.
- Adding a profile from a URL and updating it are shown in the interface but not yet supported by Core. Import a local TOML file instead.
- Profile modules, proxy deletion, rule destination probing and in-app update downloads are still pending Core support.
- eBPF and TUN require the appropriate system permissions.
- Release packages do not include GeoIP / GeoSite datasets. Place them in the Specola configuration directory when your rules need them.