Introduction
If you want a powerful, automation-friendly media-downloading tool for macOS or Linux, gallery-dl is one of the best open-source options. Unlike traditional browser extensions or GUI downloaders, gallery-dl is a lightweight command-line program designed for bulk media extraction, automation, and structured archiving.
Whether you want to build a reliable Tumblr media downloader, automate a Reddit gallery downloader, maintain a complete Tumblr blog archiver, or run a high-performance Pixiv image downloader tool, installing gallery-dl on macOS or Linux gives you full control over your workflow.
This complete guide walks you through installation on both macOS and major Linux distributions, as well as configuration, troubleshooting, and advanced automation tips.
What is gallery-dl? and How It Works on macOS & Linux
gallery-dl is an open-source Python-based command-line utility that downloads images, videos, and galleries from more than 150 supported websites. It works through “extractors,” modules designed to understand the structure of specific platforms such as Pixiv, Reddit, Tumblr, Twitter/X, and many others.
On macOS and Linux, gallery-dl runs directly inside the Terminal. Once installed, you simply provide a URL such as a subreddit, Tumblr blog, or Pixiv artist profile and the tool automatically detects the site, extracts media links, and downloads files in an organized format.
Because macOS and Linux are Unix-based systems, gallery-dl integrates extremely well with:
- Bash scripting
- Cron jobs
- Automation pipelines
- Developer workflows
- Server-based archiving systems
This makes it especially popular among developers, researchers, archivists, and automation-focused users.
System Requirements for macOS & Linux
Before installing gallery-dl, ensure you have:
- Python 3.8 or higher
- Terminal access
- pip (Python package manager)
- Internet connection
Most modern macOS and Linux systems already include Python, but the version may need updating.
How to Install gallery-dl on macOS
There are multiple installation methods on macOS. The recommended approach is using pip.
Step 1: Install or Update Python on macOS
First, check if Python is installed:
python3 –version
If Python is not installed or outdated, install it using Homebrew (recommended):
brew install python
Homebrew simplifies package management on macOS and ensures dependencies remain clean.
Step 2: Install gallery-dl Using pip
Once Python is ready, install gallery-dl with:
pip3 install gallery-dl
After installation, verify:
gallery-dl –version
If the version appears, installation was successful.
At this point, your macOS system is ready to function as a powerful Tumblr media downloader, a Reddit gallery downloader, or an automated Pixiv image downloader.
Alternative macOS Installation: Using Homebrew
Some users prefer installing via Homebrew:
brew install gallery-dl
This method simplifies updates:
brew upgrade gallery-dl
How to Install gallery-dl on Linux
Linux offers even more flexibility due to its native package management systems.
Step 1: Check Python Version
In Terminal, run:
python3 –version
If Python is missing or outdated, install it using your distribution’s package manager.
Ubuntu / Debian:
sudo apt update
sudo apt install python3 python3-pip
Fedora:
sudo dnf install python3 python3-pip
Arch Linux:
sudo pacman -S python python-pip
Step 2: Install gallery-dl via pip
After Python installation:
pip3 install gallery-dl
Verify installation:
gallery-dl –version
Now your Linux system is fully equipped for bulk media extraction.
Installing Optional Video Support (Recommended)
To enable video downloads from platforms like Twitter, Reddit, and Tumblr, install yt-dlp:
pip3 install yt-dlp
This enhances support for:
- Twitter/X videos
- Reddit hosted videos
- Tumblr embedded content
- Instagram reels
This turns gallery-dl into more than a simple Tumblr media downloader it becomes a complete multimedia extraction tool.
Creating a Configuration File (macOS & Linux)
For better organization and automation, create a configuration file.
macOS location:
~/.config/gallery-dl/config.json
Linux location:
~/.config/gallery-dl/config.json
You can define:
- Base download directory
- Metadata saving
- Folder naming structure
- Rate limits
- Authentication settings
This is especially useful when building a structured Tumblr blog archiver or managing large collections of Pixiv artists.
How to Use gallery-dl on macOS & Linux
After installation, using gallery-dl is extremely simple.
To download a Tumblr blog:
gallery-dl https://example.tumblr.com
This works perfectly as a Tumblr media downloader, grabbing images, GIFs, and videos.
To archive a subreddit:
gallery-dl https://www.reddit.com/r/wallpapers/
Ideal for running your own Reddit gallery downloader.
To download a Pixiv artist profile:
gallery-dl https://www.pixiv.net/users/123456
This functions as a complete Pixiv image downloader tool, organizing files by post ID and metadata.
To download Twitter media:
gallery-dl https://twitter.com/username
Perfect for bulk downloading tweets and media as a Twitter bulk image downloader.
Automation on macOS & Linux
One of the biggest advantages of Unix-based systems is automation.
You can create a simple shell script:
#!/bin/bash
gallery-dl https://www.reddit.com/r/EarthPorn/
Make it executable:
chmod +x script.sh
Then schedule it using cron:
crontab -e
This allows:
- Daily subreddit backups
- Weekly Tumblr blog archiver automation
- Continuous Pixiv portfolio monitoring
- Automated social media archiving
Automation is where gallery-dl truly excels compared to GUI downloaders.
Common Installation Issues & Fixes
If you see “command not found,” ensure pip is installed gallery-dl in your PATH.
Try:
python3 -m pip install –user gallery-dl
If permission errors occur, avoid using sudo unless necessary. Instead, use virtual environments:
python3 -m venv venv
source venv/bin/activate
pip install gallery-dl
Virtual environments are recommended for advanced users managing multiple Python projects.
Why macOS & Linux Users Prefer gallery-dl
Unix-based systems naturally support scripting, automation, and server deployments. gallery-dl integrates seamlessly with:
- Bash pipelines
- SSH servers
- Remote automation
- Docker containers
- Cron scheduling
For developers and power users, this means you can create a scalable Reddit gallery downloader, run a persistent Tumblr media downloader, or maintain a long-term Pixiv image downloader tool setup without browser limitations.
Conclusion
Installing gallery-dl on macOS or Linux is straightforward and unlocks one of the most powerful media extraction tools available in 2026. With just Python and a single command, you gain access to automation, bulk downloads, structured file management, and support for over 150 websites.
Whether your goal is to archive Tumblr blogs, automate downloading from subreddits, monitor Pixiv artists, or build a scalable Twitter media archive, gallery-dl offers the flexibility and efficiency that GUI tools simply cannot match.
For developers, archivists, researchers, and advanced users, installing gallery-dl on macOS or Linux is a smart long-term solution for professional media management.
FAQs – Installing gallery-dl on macOS & Linux
1. How do I install gallery-dl on macOS?
To install gallery-dl on macOS, you can use Homebrew or pip (the Python package manager).
Method 1 – Using Homebrew (Recommended for macOS users):
brew install gallery-dl
Method 2 – Using pip:
pip3 install gallery-dl
After installation, verify with:
gallery-dl –version
Homebrew is ideal for Mac users who prefer a clean package management system, while pip offers greater flexibility for automation and scripting, such as building a Tumblr media downloader, a Pixiv image downloader tool, or an automated Reddit gallery downloader system.
2. How do I install gallery-dl on Ubuntu or other Linux distributions?
On Ubuntu, Debian, and most Linux distributions, the easiest way is via pip:
sudo apt install python3-pip
pip3 install gallery-dl
You can also install via your distribution’s package manager if available, but pip ensures you get the latest version.
For Arch Linux:
sudo pacman -S gallery-dl
Linux users often prefer gallery-dl for server automation, VPS backups, and cron-based scheduling, especially when running a large-scale Tumblr blog archiver or Twitter bulk image downloader setup.
3. Do I need Python to run gallery-dl on macOS or Linux?
Yes. gallery-dl requires Python 3.8 or higher when installing via pip.
Most Linux distributions and macOS already include Python, but you may need to upgrade it. Check your version with:
python3 –version
If you’re planning automation tasks, such as scheduled subreddit backups or maintaining a long-term Pixiv image downloader tool, using the latest Python version ensures better compatibility and performance.
4. How do I update gallery-dl on macOS and Linux?
Keeping gallery-dl up to date is crucial because websites like Tumblr, Reddit, and Pixiv frequently change their structures.
To update via pip:
pip3 install –upgrade gallery-dl
To update via Homebrew (macOS):
brew upgrade gallery-dl
Regular updates prevent extraction errors and ensure your Tumblr media downloader or Reddit gallery downloader continues working without interruption.
5. Why is gallery-dl not recognized in Terminal?
If you see a “command not found” error, it usually means:
pip installed gallery-dl in a local directory not included in PATHThe
Python user directory is not exported to PATH
The terminal session needs to be restarted
Fix it by adding this to your .bashrc, .zshrc, or shell config:
export PATH=”$HOME/.local/bin:$PATH”
Then restart your terminal.
This issue is common when setting up automation environments for large-scale tasks, such as maintaining a Tumblr blog archiver or running a scheduled bulk image downloader for Twitter.
6. Can I automate gallery-dl on macOS or Linux?
Yes — and this is where gallery-dl truly excels.
You can automate downloads using:
Cron jobs (Linux/macOS)
Shell scripts
Systemd services (Linux servers)
Launch Agents (macOS)
Example cron job:
0 2 * * * gallery-dl https://www.reddit.com/r/wallpapers/
This runs daily at 2 AM.
Automation is especially useful for:
Archiving Tumblr blogs
Monitoring Pixiv artists
Backing up Reddit galleries
Running a high-volume Tumblr media downloader workflow
For developers and system administrators, gallery-dl becomes more than just a downloader it becomes a scalable media archiving solution.
Latest Post: