https://github.com/codewithgodstime/fzbot
FZBot Downloader helps you effortlessly download films and TV shows directly from the web from your terminal.
https://github.com/codewithgodstime/fzbot
aiohttp argparse asyncio
Last synced: 14 days ago
JSON representation
FZBot Downloader helps you effortlessly download films and TV shows directly from the web from your terminal.
- Host: GitHub
- URL: https://github.com/codewithgodstime/fzbot
- Owner: codeWithGodstime
- Created: 2024-10-31T19:26:36.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-04-20T18:48:59.000Z (about 1 month ago)
- Last Synced: 2025-05-07T18:16:19.926Z (14 days ago)
- Topics: aiohttp, argparse, asyncio
- Language: Python
- Homepage:
- Size: 34.2 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# FZBot Downloader
###### Effortlessly download films and TV shows directly from the web using a powerful and user-friendly terminal-based tool.
FZBot Downloader helps you effortlessly download films and TV shows directly from the web from your terminal.
### Key Features
- Download movies and TV shows with minimal input.
- Automatic URL parsing to simplify the download process.
- Resume interrupted downloads seamlessly. Lightweight and cross-platform support (Windows, macOS, Linux).
- Concurrent downloads
### Demo
### Installation
- Clone the repository
```bash
git clone https://github.com/codeWithGodstime/FZbot
```
- Create virtual environment and install dependencies
```bash
cd FZbot && virtualenv venv && pip install -r requirements.txt
```
### Usage
Basic Usage
```bash
python fzbot.py [type] [title] [-ns NUMBER_OF_SEASONS] [-ne NUMBER_OF_EPISODES]
```
### Arguments:
1. **Positional Arguments** (Required):
- **`type`**: Specify whether you want to download a movie or a series.
- Choices: `movie`, `series`
- Example: `movie` for films or `series` for TV shows.
- **`title`**: Name of the movie or series you want to download.
- Example: `"Breaking Bad"` or `"Inception"`
2. **Optional Arguments** (Optional):
- **`-ns`, `--number_of_seasons`**:
- Specify the number of seasons to download (for series only).
- Default: `1`
- Example: `--number_of_seasons 2` to download 2 seasons.
- **`-ne`, `--number_of_episodes`**:
- Specify the number of episodes to download (for series only).
- Default: `1`
- Example: `--number_of_episodes 5` to download 5 episodes.
Here's a clear and structured usage guide based on your `argparse` implementation:
---
## Usage Guide for **FZBot Downloader**
**FZBot Downloader** is a terminal-based tool for downloading movies or TV series. Use the following commands and arguments to get started:
---
### Basic Command Structure:
```bash
python fzbot.py [type] [title] [-ns NUMBER_OF_SEASONS] [-ne NUMBER_OF_EPISODES]
```
---
### Arguments:
1. **Positional Arguments** (Required):
- **`type`**: Specify whether you want to download a movie or a series.
- Choices: `movie`, `series`
- Example: `movie` for films or `series` for TV shows.
- **`title`**: Name of the movie or series you want to download.
- Example: `"Breaking Bad"` or `"Inception"`
2. **Optional Arguments** (Optional):
- **`-ns`, `--number_of_seasons`**:
- Specify the number of seasons to download (for series only).
- Default: `1`
- Example: `--number_of_seasons 2` to download 2 seasons.
- **`-ne`, `--number_of_episodes`**:
- Specify the number of episodes to download (for series only).
- Default: `1`
- Example: `--number_of_episodes 5` to download 5 episodes.
---
### Examples:
1. **Download a Movie**:
```bash
python fzbot.py movie "Inception"
```
2. **Download a TV Series (Default 1 season, 1 episode)**:
```bash
python fzbot.py series "Breaking Bad"
```
3. **Download Multiple Seasons of a TV Series**:
```bash
python fzbot.py series "Breaking Bad" -ns 2
```
4. **Download Multiple Episodes of a TV Series**:
```bash
python fzbot.py series "Breaking Bad" -ns 1 -ne 10
```