gofile-tui 🚀

Fast, Zero-Dependency Terminal File Uploader & Link Generator
Pure Python Standard Library (0 pip dependencies). Cross-platform on Windows, macOS, and Linux.

⚡ Highlights

• Zero Dependencies: 100% Python Standard Library. Zero pip dependencies needed to run.
• Flicker-Free Terminal UI: Native ANSI-powered interface with dirty-state rendering and windowed scrolling.
• Blazing Fast Transfers: Dual-engine architecture with libcurl process acceleration and tuned non-blocking Python streaming socket fallback.
• Multi-Worker Concurrency: Upload up to 1000 files in parallel with live per-slot progress and aggregate sparkline graphs.
• Terminal QR Code Generator: Pure Python ISO/IEC 18004 QR engine renders scannable QR codes directly in your terminal for instant mobile downloads.
• Bandwidth Throttler: Integrated token-bucket rate limiter to prevent saturating your connection.
• Auto-Archive to ZIP: Bundle files or entire folder hierarchies directly from the TUI.
• Session Preservation & History: Automatic session saving with crash recovery and history browser.
• Executive Multi-Format Reports: 1-click export to interactive dark-mode HTML, Markdown tables, CSV, or structured JSON.

📦 Installation

pip install gofile-tui

Or install using pipx for isolated CLI usage:

pipx install gofile-tui

🚀 Quick Start

Launch the interactive terminal interface:

gofile-tui

(Alias gofile is also available)

Or pass files directly from the command line:

gofile-tui file1.zip /path/to/video.mp4

You can also run it via Python module invocation:

python -m gofile

⌨️ Keybindings & Controls

🔒 Private Buckets & Security

gofile-tui provides flexible privacy and access control options:

• Password Protection: Encrypt folder access with a password. Anyone visiting the download link must enter the password to download files.
• Account-Private Folders: Mark buckets as private (public=False) so only your account token can access them.
• 1-Click Web Login: If you create private folders, you can authenticate your web browser in one click! Press [o] or press [g] -> [l] to open https://gofile.io/login/<TOKEN>, which immediately logs your browser in so you can view, download, and manage your private files in "My Files".
• Custom Folder ID: Directly target an existing Gofile folder ID from your account dashboard.

Configure interactively inside the TUI by pressing [g] (Buckets & Security), or via CLI flags:

# Upload to a password-protected bucket
gofile-tui -p "mySecretPass" file.zip

# Upload to an account-private bucket
gofile-tui --private file.zip

# Upload directly into an existing Gofile folder
gofile-tui --folder-id "fld-1234abcd" file.zip

📁 Clean Isolated Storage (gofile-files/)

All application runtime data, credentials, and logs are automatically kept in a dedicated gofile-files/ subfolder inside your current working directory to keep your project directories clean:

• gofile-files/gofile.txt: Permanent upload log with filenames and download URLs.
• gofile-files/session.json: Active transfer queue state and resume checkpoints.
• gofile-files/token.txt: Authenticated Gofile API account token.
• gofile-files/sessions/: Historical session archive backups.
• gofile-files/reports/: Exported HTML dashboards, Markdown summaries, CSVs, and JSON files.

🎨 Built-In Color Themes

gofile-tui features 6 built-in color schemes switchable on the fly ([t]):

1. Cyan Modern (Default)
2. Cyberpunk Neon
3. Nord Arctic Frost
4. Gruvbox Warm
5. Monokai Pro
6. Monochrome Minimal

📄 License

MIT License © 2026 Rituraj