cftui 0.1.0

Manage Cloudflare DNS records from your terminal.

cftui

Manage Cloudflare DNS records from your terminal.

---

cftui = Cloudflare TUI

• GitHub  →  github.com/Marshmellond/cftui
• PyPI    →  pypi.org/project/cftui

中文文档

Features

• Browse, add, edit, and delete DNS records
• Supports A, AAAA, CNAME, MX, TXT, NS, SRV, CAA record types
• Toggle Cloudflare proxy (orange cloud) on/off
• Built-in settings screen — no manual config file editing required
• Cross-platform: Windows, macOS, Linux
• Configurable via environment variables or TOML file

Installation

pipx

pipx install cftui

uv

uv tool install cftui

pip

pip install cftui

Run without installing

uvx cftui

Usage

cftui

Key bindings

Key	Action
Ctrl+S	Open settings
Ctrl+R	Refresh records
a	Add a new record
Enter	Edit selected record
d	Delete selected record
Ctrl+C / Ctrl+Q	Quit

Configuration

On first launch, cftui creates a config file at:

Platform	Path
Windows	%APPDATA%\cftui\config.toml
macOS	~/Library/Application Support/cftui/config.toml
Linux	~/.config/cftui/config.toml

You can configure everything from the built-in settings screen (Ctrl+S), or edit the file manually.

config.toml

# Cloudflare API Token
# Create at: https://dash.cloudflare.com/profile/api-tokens
# Permission: Zone · DNS · Edit
api_token = "your_token_here"

# Zone identifier (choose ONE)
zone_name = "example.com"
zone_id = ""

Environment Variables

All config values can also be set via environment variables:

Variable	Equivalent
CFD_API_TOKEN	api_token
CFD_ZONE_NAME	zone_name
CFD_ZONE_ID	zone_id

API Token

Create a Cloudflare API token at dash.cloudflare.com/profile/api-tokens.

Required permission: Zone · DNS · Edit

Zone

Pick one:

• Zone Name — your domain, e.g. example.com
• Zone ID — found on the Cloudflare dashboard overview page

Development

git clone https://github.com/Marshmellond/cftui.git
cd cftui
uv sync
uv run cftui

Python 3.11+ required.

License

MIT