FileUploader

Unified Python tooling for uploading files through CLI, GUI, and TUI workflows.

FileUploader gives you one normalized upload core for temporary file hosts, cloud-backed providers, and legacy upload scripts. Use it from a modern CLI, a lightweight desktop GUI, or a Rich-powered terminal UI.

Created by j0rd1s3rr4n0: jordiserrano.me | github.com/j0rd1s3rr4n0

Why FileUploader

Most file hosts expose different request shapes, response formats, and failure messages. FileUploader wraps them behind one interface with normalized provider metadata, upload results, and errors.

What you need	Use this
Quick public link, no account	catbox, fileio, 0x0, tempsh, transfersh, gofile
Automation and scripting	python -m fileuploader_cli ... --json --no-banner
Desktop workflow	python -m fileuploader_gui
Interactive terminal flow	python -m fileuploader_tui
Account-backed storage	4shared, box, dropbox, mediafire, jsonbin, anonfilesnew

Interfaces

Interface	Command	Best for
CLI	python -m fileuploader_cli	Scripts, CI jobs, JSON output, repeatable commands
Package CLI	python -m fileuploader	Equivalent package entrypoint for the same CLI
GUI	python -m fileuploader_gui	Provider-aware desktop uploads and copyable results
TUI	python -m fileuploader_tui	Guided terminal use with Rich tables and prompts

Quick Start

Install dependencies:

git clone https://github.com/j0rd1s3rr4n0/FileUploader.git
cd FileUploader
python -m pip install -r requirements.txt

List providers:

python -m fileuploader_cli services

Upload without registration:

python -m fileuploader_cli upload --service catbox path/to/file.txt

Upload with JSON output for scripts:

python -m fileuploader_cli upload --service gofile path/to/file.txt --json

Hide the banner for automation:

python -m fileuploader_cli --no-banner services

Launch the desktop GUI:

python -m fileuploader_gui

Launch the terminal UI:

python -m fileuploader_tui

Common Workflows

No Account Required

Use these first when you just need a public link and do not want to create an account or pass tokens:

python -m fileuploader_cli upload --service catbox path/to/file.txt
python -m fileuploader_cli upload --service fileio path/to/file.txt
python -m fileuploader_cli upload --service 0x0 path/to/file.txt
python -m fileuploader_cli upload --service transfersh path/to/file.txt
python -m fileuploader_cli upload --service tempsh path/to/file.txt

Copy-Friendly Output

Human output is readable by default. JSON output is clean and banner-free:

python -m fileuploader_cli upload --service gofile path/to/file.txt --json

Some workflows also support copying processed output:

python -m fileuploader_cli upload --service catbox path/to/file.txt --copy

API Keys and Tokens

Pass credentials directly:

python -m fileuploader_cli upload --service anonfilesnew path/to/file.txt --api-key YOUR_API_KEY
python -m fileuploader_cli upload --service box path/to/file.txt --api-key BOX_OAUTH_ACCESS_TOKEN
python -m fileuploader_cli upload --service 4shared path/to/file.txt --api-key "oauth_token=...&oauth_signature=..."

Or read them from environment variables:

set ANONFILESNEW_API_KEY=YOUR_API_KEY
python -m fileuploader_cli upload --service anonfilesnew path/to/file.txt --api-key-env ANONFILESNEW_API_KEY

Guided CLI

When you do not remember the flags, use the guided flow:

python -m fileuploader_cli guided

CLI Reference

python -m fileuploader_cli [--no-banner] services [--json] [--active-only]
python -m fileuploader_cli [--no-banner] guided
python -m fileuploader_cli [--no-banner] upload PATH --service SERVICE [--api-key KEY] [--api-key-env ENV] [--json] [--plaintext] [--copy] [--verbose]
python -m fileuploader_cli [--no-banner] download --service SERVICE [--url URL] [--server SERVER --file-id FILE_ID --filename NAME] [--json]
python -m fileuploader_cli [--no-banner] info FILE_ID --service SERVICE [--api-key KEY] [--api-key-env ENV] [--json]

Preview

CLI service list:

Service       Upload  Download  Info  API key  Status
------------  ------  --------  ----  -------  ------
catbox        yes     no        no    no       active
fileio        yes     no        no    no       active
gofile        yes     yes       no    no       active
jsonbin       yes     no        no    yes      active
mega          no      no        no    yes      disabled

GUI workflow:

Choose provider -> choose action -> enter only required fields -> run -> copy result

TUI workflow:

Rich provider table -> guided prompts -> normalized result panel

Features

Feature	Description
Unified provider core	One interface for provider metadata, upload results, and provider errors.
Provider-aware UX	CLI, GUI, and TUI ask only for the fields needed by the selected action.
No-registration providers	Many services work without account creation or API keys.
Account-backed providers	Box, Dropbox, MediaFire, JSONBin, and AnonFilesNew support token/key workflows.
JSON automation	--json returns parseable output without banner text.
Script-friendly banner control	--no-banner hides the terminal banner for automation.
Clipboard support	Copy supported outputs directly from CLI/GUI flows.
GoFile encryption workflow	Legacy GoFile scripts support AES-GCM encrypt/decrypt helpers.
Testable design	Tests use mocked providers and avoid real network calls.

Provider Matrix

Provider	Service	Upload	Download	Info	API key	Status
0x0.st	0x0	Yes	No	No	No	Active
4shared	4shared	Yes	No	Yes	Yes	Active
AnonFilesNew	anonfilesnew	Yes	No	Yes	Yes	Active
blipbin	blipbin	Yes	No	No	No	Active
Box	box	Yes	No	Yes	Yes	Active
Catbox	catbox	Yes	No	No	No	Active
cupload.io	cupload	Yes	No	No	No	Active
Dropbox	dropbox	Yes	No	Yes	Yes	Active
dropfile.dev	dropfiledev	Yes	No	No	No	Active
EasySend	easysend	Yes	No	No	No	Active
file.io	fileio	Yes	No	No	No	Active
GoFile	gofile	Yes	Yes	No	No	Active
JSONBin	jsonbin	Yes	No	No	Yes	Active
Litterbox	litterbox	Yes	No	No	No	Active
MediaFire	mediafire	Yes	No	No	Yes	Active
MoonPush	moonpush	Yes	No	Yes	No	Active
qurl.sh	qurl	Yes	No	No	No	Active
Temp.sh	tempsh	Yes	No	No	No	Active
tmpfile.link	tmpfilelink	Yes	No	No	No	Active
transfer.sh	transfersh	Yes	No	No	No	Active
Uguu	uguu	Yes	No	No	No	Active
MEGA	mega	No	No	No	Yes	Disabled
AnonFiles	anonfiles	Yes	No	No	No	Deprecated
BayFiles	bayfiles	Yes	No	No	No	Deprecated

Provider Notes

Recommended No-Registration Providers

Service	Good for
catbox	Simple public file links
fileio	Temporary links with JSON responses
0x0	Minimal terminal uploads
tempsh	Temporary file sharing
transfersh	Terminal-first uploads via PUT
gofile	Upload plus basic download support

Retention, file size limits, rate limits, and content policies are controlled by each upstream provider.

Account-Backed Providers

Service	Credential
4shared	OAuth query parameters
anonfilesnew	API key
box	OAuth access token
dropbox	OAuth access token
jsonbin	JSONBin API key
mediafire	MediaFire session token

Prefer --api-key-env for repeat usage so secrets stay outside shell history.

For 4shared, pass the already signed OAuth query string through --api-key or FOURSHARED_OAUTH_PARAMS. The provider uses the simple upload endpoint for files below 150 MB and uploads to folder 0 unless a future interface supplies a different folder_id.

Disabled and Deprecated Providers

Disabled providers are shown in service lists but are not offered as active GUI choices. Deprecated providers remain available for compatibility, but upstream APIs may fail or disappear.

MEGA is currently disabled because reliable uploads need MEGAcmd or an SDK-backed implementation rather than a simple HTTP upload endpoint.

Security and Privacy

• Treat public upload links as public unless the provider explicitly says otherwise.
• Do not upload secrets, private keys, credentials, or sensitive personal data to public hosts.
• Prefer environment variables for tokens and API keys.
• FileUploader normalizes provider responses, but storage, deletion, retention, and abuse policies belong to each upstream service.
• Local tests use mocked HTTP clients and do not upload files.

Legacy Workflows

The unified interfaces should be the default for new usage. Legacy provider scripts remain available for specialized flows.

GoFile encryption helpers:

python GoFile/main.py -u path/to/file.txt --encrypt --password "your-password"
python GoFile/main.py --decrypt-file file.txt.enc --password "your-password" --decrypt-output file.txt

AnonFilesNew legacy entrypoint:

python AnonFilesNew.com/anonfilesnew.py path/to/file.txt --api-key YOUR_API_KEY --json

JSONBin chunk uploader:

python JSONBin.com/jsonbin_uploader.py upload path/to/file.txt --api-key YOUR_API_KEY --manifest upload-manifest.json

Development

Install locally:

git clone https://github.com/j0rd1s3rr4n0/FileUploader.git
cd FileUploader
python -m pip install -r requirements.txt

Run tests:

python -m unittest discover -s tests

Compile modules:

python -m compileall fileuploader fileuploader_cli.py fileuploader_gui.py fileuploader_tui.py

Smoke checks:

python -m fileuploader_cli services --json
python -m fileuploader_cli --no-banner services
python -c "from fileuploader_tui import service_table; print(len(service_table().rows))"
python -c "import fileuploader_gui; print(fileuploader_gui.default_state())"

Project layout:

fileuploader/       Shared provider core, registry, formatters, and CLI
fileuploader_cli.py CLI-only launcher
fileuploader_gui.py Tkinter desktop interface
fileuploader_tui.py Rich terminal interface
GoFile/             Legacy GoFile scripts and encryption helpers
AnonFilesNew.com/   Legacy AnonFilesNew scripts
JSONBin.com/        JSONBin chunk uploader
tests/              Unit and smoke tests
docs/               Interface documentation

Roadmap

Planned improvements:

• Provider health checks and capability reporting.
• Batch uploads across CLI, GUI, and TUI.
• Local upload history with export.
• Config profiles for defaults and environment variable names.
• Retry, timeout, and backoff policy.
• Output formats for URL-only, Markdown, HTML, text, and JSON.
• Packaging with installable console commands.

Contributing

Pull requests are welcome. For larger changes, open an issue with:

• the user-facing behavior;
• affected providers or interfaces;
• expected tests;
• compatibility risks.

Keep new providers behind the shared provider core and cover them with mocked tests.

License

MIT