Skip to content

specola v0.2.2-beta

Choose a tag to compare

@getspecola getspecola released this 27 Sep 17:05
· 2 commits to main since this release
a8b26d3

This beta rebuilds the desktop interface around routing, simplifies the TOML profile format, and adds server deployment tools. Only the Linux x86_64 GCC build is published for this release.

Breaking changes: profile format

Profiles written for 0.2.1 must be updated. Core rejects unknown top-level tables.

  • [rule] list = [...] becomes [route] rules = [...].
  • Rule sets, GeoIP and GeoSite move under [route] as inline tables, for example rule-set = [{ name = "private", type = "local", behavior = "domain" }] and geoip = { type = "local" }.
  • [metadata] and [[proxy-provider]] are no longer accepted.
  • Enhanced mode uses backend = "tun" or backend = "ebpf" with inline tun = { ... } or ebpf = { ... } settings.
  • DNS settings are simplified, with listener, nameserver-proxy, hosts and ipv6 options.
  • Nested [proxy.tls] tables are written inline as tls = { enabled = true }.
  • GeoIP, GeoSite and rule sets without a path are loaded from the Specola configuration directory (~/.config/specola on Linux).

Convert Clash / mihomo YAML profiles with the Clash to Specola converter.

Proxy

  • Hysteria2 and TUIC can be chained through a dialer proxy.

Desktop interface

  • Overview: redesigned with a route distribution bar, the selected proxy group and node, live throughput and Top traffic by host, outbound or process.
  • Sidebar: Monitor, Routing and Servers groups, a collapsible layout, live Core status, and alerts for new errors.
  • Connections and Logs: separate pages with filtering, connection details, process routing, and a 10,000-entry log buffer.
  • Proxies, Groups, Rules and DNS: dedicated pages with latency, traffic, group member selection, a rules editor with reordering, and DNS query and cache views.
  • Profiles: subscription and local groups, usage details, and first-run guidance.
  • Servers: SSH deployment and server monitoring with history charts.
  • Settings: searchable categories, Core connection management, and version diagnostics.
  • System tray: the tray now opens a single popup with route controls, traffic history and proxy selection. On macOS the native menu no longer opens alongside it.
  • Shortcuts: configurable shortcuts cycle the route mode and turn proxying on or off. They are global on macOS and Windows, and work in the app window on Linux.
  • Launch at login can be enabled under Settings → General.
  • Core status: when Core is missing, stopped or failed, pages that need Core show what happened, the locations searched, and actions to start Core, search again, or choose the executable.
  • System fonts are used throughout the interface.

Packaging

  • Linux archive: specola-0.2.2-linux-x86_64-gcc.tar.gz.

Getting started and limitations

  • This is a beta prerelease.
  • Update existing profiles to the new format before loading them.
  • Import a TOML profile and activate it manually after launching the application.
  • 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.
  • Several workflows still show a pending state until Core support is available, including proxy deletion, rule destination probing, subscription and module operations, and in-app update downloads.