Metadata-Version: 2.4
Name: gofile-tui
Version: 2.0.1
Summary: Fast, zero-dependency TUI file uploader and link generator with parallel transfers, QR sharing, and HTML reports.
Author: Rituraj
License-Expression: MIT
Keywords: tui,uploader,cli,file-sharing,gofile,terminal,qr-code
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Communications :: File Sharing
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# gofile-tui 🚀

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

[![PyPI version](https://img.shields.io/pypi/v/gofile-tui.svg)](https://pypi.org/project/gofile-tui/)
[![Python versions](https://img.shields.io/pypi/pyversions/gofile-tui.svg)](https://pypi.org/project/gofile-tui/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

---

## ⚡ 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

```bash
pip install gofile-tui
```

Or install using `pipx` for isolated CLI usage:

```bash
pipx install gofile-tui
```

---

## 🚀 Quick Start

Launch the interactive terminal interface:

```bash
gofile-tui
```
*(Alias `gofile` is also available)*

Or pass files directly from the command line:

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

You can also run it via Python module invocation:

```bash
python -m gofile
```

---

## ⌨️ Keybindings & Controls

| Key | Action |
|---|---|
| `[SPACE]` / `[ENTER]` | Start / Pause upload queue |
| `[s]` | Stop active uploads / Skip selected file |
| `[b]` | Open local file browser & subfolder search |
| `[a]` | Paste paths or drag & drop files |
| `[w]` | Multi-worker concurrency dashboard |
| `[p]` / `[0-9]` | Configure parallel upload slots (1 to 1000) |
| `[L]` | Bandwidth speed limiter (presets or custom MB/s cap) |
| `[g]` | Bucket strategy (Single shared folder vs. separate links) |
| `[Q]` | Display scannable ASCII QR code in terminal |
| `[o]` | Open completed bucket or link in default web browser |
| `[c]` | Copy download link to system clipboard |
| `[t]` | Color theme preset switcher (Cyberpunk, Nord, Gruvbox, Monokai, etc.) |
| `[S]` | Sort queue (file size, alphabetical, status, or reset) |
| `[T]` | Boost selected file to top of upload queue |
| `[v]` | Toggle batch multi-selection mode |
| `[x]` | Clear completed `[DONE]` items from active queue |
| `[r]` | Retry current file or all failed/skipped items |
| `[e]` | Export session report (HTML, Markdown, CSV, JSON) |
| `[H]` | Session archive manager (resume or inspect past uploads) |
| `[/]` | Live queue search / fuzzy filter |
| `[q]` | Quit application |

---

## 🎨 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
