How soul7hu/walrus works
Walrus is a Telegram-controlled transfer bot: users submit Telegram files or direct links, the bot downloads and queues them, and a separate worker uploads them to a chosen Rubika destination. The queue and task files persist transfer state shared across the processes. The README documents account setup, destination selection, retries, cancellation, progress, cleanup, and large-file archive volumes. Some implementation details are unsampled, so undocumented wiring is omitted.
Main entry points: telegram_bot.py Bot controls · task_store.py Queue and task state · rubika_worker.py Upload worker · rubika_auth_helper.py Rubika account setup
Components 16
Telegram Intake
- Bot controls
telegram_bot.py - Telegram files
telegram_bot.py - Direct-link download
telegram_bot.py - Link batches
telegram_bot.py
Transfer Processing
- Upload worker
rubika_worker.py - Volume archiving
rubika_worker.py - Progress and retry
rubika_worker.py - Cleanup and recovery
telegram_bot.py
Task State
- Queue and task state
task_store.py - Downloaded files
task_store.py
Rubika Integration
- Rubika account setup
rubika_auth_helper.py - Destination settings
telegram_bot.py
Other components
- Telegram user
- Rubika service
- Telegram service
- 7-Zip
Connections 25
- Telegram user → Bot controls: submits commands
README.md - Bot controls → Telegram files: accepts files
README.md - Bot controls → Direct-link download: downloads links
telegram_bot.py - Bot controls → Link batches: queues links
README.md - Telegram files → Queue and task state: queues tasks
README.md - Direct-link download → Queue and task state: queues tasks
README.md - Link batches → Queue and task state: queues tasks
README.md - Direct-link download → Downloaded files: writes downloads
telegram_bot.py - Queue and task state → Downloaded files: tracks paths
task_store.py - Upload worker → Queue and task state: reads queue
rubika_worker.py - Upload worker → Downloaded files: reads task files
rubika_worker.py - Upload worker → Volume archiving: prepares volumes
rubika_worker.py - Volume archiving → 7-Zip: runs archives
rubika_worker.py - Upload worker → Progress and retry: updates transfers
rubika_worker.py - Upload worker → Rubika service: uploads files
README.md - Upload worker → Telegram service: sends updates
rubika_worker.py - Bot controls → Telegram service: handles bot UI
README.md - Bot controls → Queue and task state: manages transfer state
telegram_bot.py - Bot controls → Cleanup and recovery: offers cleanup
README.md - Cleanup and recovery → Downloaded files: removes safe files
telegram_bot.py - Bot controls → Destination settings: changes destination
README.md - Destination settings → Queue and task state: saves settings
task_store.py - Telegram user → Rubika account setup: provides login details
- Rubika account setup → Rubika service: authenticates account
- Progress and retry → Queue and task state: records outcomes
rubika_worker.py