gofile-tui 🚀

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

┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ GOFILE TUI UPLOADER (v2.2.8)                                                 ┃
┃ ⏸ PAUSED • Done: 2 | Rem: 0 | Speed: [ ▂▄▆█▄▂ ] 48.2 MB/s                   ┃
┃ Bucket: https://gofile.io/d/abc12345 [SAME BUCKET] (Press [o] open, [g] change)┃
┃ Login: https://gofile.io/login/your_account_token                            ┃
┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
┃ File: Idle - No active upload. Mode: MULTI[5]                                ┃
┃ Overall: 2/2 done (124.5 MB/124.5 MB) | Speed: [ ▂▄▆█▄▂ ] --                ┃
┃ [██████████████] 100% | Status: Completed                                    ┃
┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
┃   [DONE] document.pdf       |    2.4 MB | https://gofile.io/d/xyz89012        ┃
┃   [DONE] video.mp4          |  122.1 MB | https://gofile.io/d/abc12345        ┃
┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
┃ [SPACE] Start  [s] Stop  [p] Slots(5)  [w] Workers  [L] Limit  [o] Open      ┃
┃ [g] Buckets  [/] Search  [H] History  [t] Theme  [e] Export  [Q] QR          ┃
┃ [S] Sort  [T] Top  [v] Select  [x] Clear  [r] Retry  [b] Browse  [q] Quit     ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

⚡ 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.
• Self-Healing Token Lifecycle: Automated Gofile token health checks that seamlessly auto-renew expired or stale credentials without manual intervention.
• Header 1-Click Login Link: Direct display of your account's 1-click web login link (https://gofile.io/login/<token>) right in the top header.
• 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

Command-Line Options

⌨️ 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