Installation

📋 System Requirements

🐍 Python

Version 3.9+

python --version

🎵 FFmpeg

Audio processing

ffmpeg -version

🛠 Installing FFmpeg

macOS

brew install ffmpeg

Linux (Ubuntu/Debian)

sudo apt update && sudo apt install ffmpeg

Windows

Using Chocolatey

choco install ffmpeg

Using Scoop

scoop install ffmpeg

Using Winget

winget install ffmpeg

Other systems: Install FFmpeg using your package manager

🚀 Quick Installation

One-Line Install (Recommended)

pip install tokysnatcher

Alternative: Install from Source

If you want the latest development version:

pip install git+https://github.com/rahaaatul/TokySnatcher.git

Using uv (Modern Package Manager)

uv pip install tokysnatcher

🎯 Quick Start

After installation, run TokySnatcher for the first time:

# Basic usage
tokysnatcher

# Or use the short alias
toky

First Run Example

🚀 TokySnatcher - Audiobook Downloader

Choose action:
❯ Search book
  Download from URL
  Exit

✅ Verify Your Setup

Ensure everything is working correctly:

Check Installation

tokysnatcher --version
# Output: TokySnatcher v0.3.3

Check FFmpeg

ffmpeg -version | head -1
# Output: ffmpeg version 6.1.1

Aliases Available

TokySnatcher provides two convenient aliases:

• tokysnatcher (full name)
• toky (short alias)

Both commands work identically!

🐛 Troubleshooting

FFmpeg Not Found

If you encounter FFmpeg-related errors:

1. Ensure FFmpeg is installed and accessible via your system's PATH
2. Restart your terminal/command prompt
3. If using virtual environments, install FFmpeg system-wide

Python Version Issues

TokySnatcher requires Python 3.9+. Check your version:

python --version

If you have multiple Python versions, use python3 instead of python