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

🎨 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