ocom

A unified TUI for managing network/privacy tools: OpenVPN, SpoofDPI/GoodbyeDPI, and Cloudflare WARP.

Cross-platform: macOS, Linux, and Windows.

Features

• OpenVPN: Connect/disconnect using .ovpn config files (sudo on Unix, Administrator on Windows)
• SpoofDPI (Unix) / GoodbyeDPI (Windows): DPI bypass tools
• Cloudflare WARP: Toggle WARP VPN connection
• Tailscale: Toggle mesh VPN connection (tailscale up/down)
• Real-time logs: Live output from all tools in a dedicated panel
• Install guidance: Tools not installed show an Install button that opens documentation
• Conflict resolution: Automatically stops conflicting tools (e.g., WARP stops when starting OpenVPN)
• Extensible: Easy to add new tools

Installation

ocom is a standalone end-user tool. Install it into an isolated environment with your preferred installer:

uv tool install ocom

pipx install ocom

Or run it without installing:

uvx ocom

On macOS/Linux, install it from the Homebrew tap:

brew install hasansezertasan/tap/ocom

On Windows, install it from the Scoop bucket:

scoop bucket add hasansezertasan https://github.com/hasansezertasan/scoop-bucket
scoop install hasansezertasan/ocom

Or install from source — see the installation docs.

Verify the installation

The package root is importable after installation:

>>> from ocom import __doc__
>>> isinstance(__doc__, str)
True

Usage

Launch the TUI with the interactive subcommand:

ocom interactive

The same command also works as a small CLI — running ocom with no arguments (or ocom --help) lists everything:

ocom version   # print the version
ocom info      # version + Python/platform details

Keyboard Shortcuts

Configuration

ocom reads a TOML config file at ~/.config/ocom/config.toml (the same path on Linux and macOS). If the file doesn't exist, the defaults below are used.

[general]
refresh_interval = 2
auto_connect = false

[openvpn]
enabled = true
config_dirs = ["~/.openvpn", "~/vpn-configs"]
default_config = ""

[spoofdpi]
enabled = true
dns_addr = "8.8.8.8:53"
dns_mode = "https"
port = 8080
system_proxy = false

[warp]
enabled = true
mode = "warp"

[tailscale]
enabled = true

[goodbyedpi] # Windows only
enabled = true
mode = 9
block_quic = true

Options

[general]

[openvpn]

[spoofdpi] (Unix)

[warp]

[tailscale]

Mesh mode only: ocom runs tailscale up/down and reads tailscale status --json. It does not configure an exit node, so Tailscale coexists with OpenVPN/WARP rather than conflicting. On Linux, controlling Tailscale without sudo requires setting the operator once: sudo tailscale set --operator=$USER.

[goodbyedpi] (Windows)

GoodbyeDPI must be run with Administrator privileges; ocom checks for them and reports a clear error if they are missing.

Auto-connect

When auto_connect = true, ocom attempts to connect to OpenVPN on startup using openvpn.default_config (which must point to a valid .ovpn file). On Unix a sudo password prompt appears immediately; on Windows the connection starts automatically (run as Administrator).

[general]
auto_connect = true

[openvpn]
default_config = "~/.openvpn/my-server.ovpn"

Configuration is validated with Pydantic, so out-of-range values (e.g. an invalid dns_mode or a port outside 1–65535) are rejected at load time. Settings come from the TOML file only — environment variables are not read.

Requirements

• Python 3.14+
• OpenVPN (for OpenVPN support)
• warp-cli (for WARP support)
• spoofdpi (Unix) or goodbyedpi (Windows) for DPI bypass

License

MIT