GoFile Downloader

This script is a utility for downloading files from GoFile, supporting both public and password-protected albums.

Features

• Downloads multiple files from an album concurrently.
• Supports batch downloading via a list of URLs.
• Supports downloading password-protected albums by providing a password.
• Supports custom download location.
• Supports selective album downloads (interactive file/folder selection).
• Progress indication during downloads.
• Automatically creates a directory structure for organized storage.
• Logs URLs that encounter errors for troubleshooting.

Dependencies

• Python 3
• requests - for HTTP requests
• rich - for progress display in the terminal.

Show directory structure

project-root/
├── helpers/
│ ├── managers/
│ │ ├── live_manager.py      # Manages a real-time live display
│ │ ├── log_manager.py       # Manages real-time log updates
│ │ └── progress_manager.py  # Manages progress bars
│ ├── config.py              # Manages constants and settings used across the project
│ ├── download_utils.py      # Utilities for managing the download process
│ ├── file_utils.py          # Utilities for managing file operations
│ ├── general_utils.py       # Miscellaneous utility functions
│ └── gofile_utils.py        # Utilities for checking GoFile status and URL validation
├── downloader.py            # Module for initiating downloads from specified GoFile URLs
├── main.py                  # Main script to run the downloader
├── URLs.txt                 # Text file listing album URLs to be downloaded
└── session_log.txt          # Log file for recording session details

Installation

1. Clone the repository:

git clone https://github.com/Lysagxra/GoFileDownloader.git

2. Navigate to the project directory:

cd GoFileDownloader

3. Install the required dependencies:

pip install -r requirements.txt

Single Album Download

To download a single album, you can use downloader.py, running the script with a valid album URL.

Usage

python3 downloader.py <gofile_url>

Example

python3 downloader.py https://gofile.io/d/clgeTz

Password-Protected Album Download

To download a password-protected album, you can use downloader.py, running the script with the album password.

Usage

python3 downloader.py <gofile_url> <password>

Example

python3 downloader.py https://gofile.io/d/hXHGR1 TestPassword

Album Selection Modes

By default, album downloads use interactive selection mode and prompt you to choose which files/folders to download.

Options

• --selection-mode interactive (default): prompts for selection.
• --selection-mode all: downloads every file in the album.
• --selection-mode none: skips all files.
• --selection "1,3,5" or --selection "1-5": provide selection directly (used in interactive mode without prompt).
• --compare-path <local_path>: recursively compares all local files in <local_path> against GoFile folder-group entries and marks existing items as [EXISTS] in interactive selective mode (no artificial small file-count cap).

Examples

python3 downloader.py <gofile_url> --selection-mode all
python3 downloader.py <gofile_url> --selection "1,3,5"
python3 downloader.py <gofile_url> --selection "1-4"
python3 downloader.py <gofile_url> --selection-mode interactive --compare-path /path/to/local/folder

Batch Download

To batch download from multiple URLs, you can use the main.py script. This script reads URLs from a file named URLs.txt and downloads each one using the media downloader.

Usage

1. Create a file named URLs.txt in the root of your project, listing each URL on a new line.

• Example of URLs.txt:

https://gofile.io/d/clgeTz
https://gofile.io/d/FrYeIy
https://gofile.io/d/jLWdTZ

• Ensure that each URL is on its own line without any extra spaces.
• You can add as many URLs as you need, following the same format.

2. Run the batch download script:

python3 main.py

File Download Location

If the --custom-path <custom_path> argument is used, the downloaded files will be saved in <custom_path>/Downloads. Otherwise, the files will be saved in a Downloads folder created within the script's directory

Usage

python3 main.py --custom-path <custom_path>

Example

python3 main.py --custom-path /path/to/external/drive

Logging

The application logs any issues encountered during the download process in a file named session_log.txt. Check this file for any URLs that may have been blocked or had errors.