A tool for downloading media from www.passes.com. You can download images and videos from posts in a user's feed or messages with some convenient filtering options. The download process is fast and efficient as the requests and file writes are made asynchronously.
$ pip install -r requirements.txt
To download videos, you'll need to install FFmpeg.
| OS | Command |
|---|---|
| Debian | apt-get install ffmpeg |
| MacOS | brew install ffmpeg |
| Windows | winget install ffmpeg |
You can also download the latest static build from here.
You will need to provide a refresh token or account credentials in the config.toml file. If you sign in directly with the website, you can provide your email and password in the configuration file, and the tool will automatically obtain a new refresh token when needed. If you use a third-party service to sign in to your account (Google, Facebook, X, Twitch), you'll need to do the following to obtain a refresh token:
- Open the developer tools in your browser (F12)
- Go to the "Network" tab
- Sign in to your account with the third-party service
- In the "Network" tab, find the request with the URL
https://www.passes.com/auth/success - Within the query parameters of the request, you'll find the
refreshTokenparameter. Copy the value of this parameter and paste it into therefresh_tokenfield in the configuration file
Refresh tokens expire after two weeks, so you'll need to update it periodically.
Usage: main.py [-h] (--feed USERNAME | -m USERNAME | -a USERNAME | --urls URLS [URLS ...] | --file FILE) [-o OUTPUT] [--from FROM_TIMESTAMP] [-t TO_TIMESTAMP] [--limit LIMIT] [-s {small,medium,large}] [-fd] [-ncf] [-i | -v]
A tool for downloading media from www.passes.com
Options:
-h, --help show this help message and exit
--feed USERNAME Download media from posts in a user's feed
-m, --messages USERNAME
Download media from posts in a user's messages
-a, --all USERNAME Download media from posts in a user's feed and messages
--urls, --links URLS [URLS ...]
A list of post URLs to download media from
--file FILE A file containing a list of post URLs to download media from
-o, --output OUTPUT The output directory to save media to
--from FROM_TIMESTAMP
The creation timestamp of posts to start downloading media from
-t, --to TO_TIMESTAMP
The creation timestamp of posts to stop downloading media
--limit LIMIT The maximum number of posts in the user's feed or messages to download media from
-s, --size {small,medium,large}
The size of the images to download
-fd, --force-download
Force downloading the media even if it already exists in the output directory
-ncf, --no-creator-folders
Don't create subfolders for each creator
-i, --images Only download images
-v, --videos Only download videos
Download images and videos from posts in a user's feed:
$ python main.py --feed thebigpodwithshaq
Download images and videos from the three most recent accessible posts in a user's messages:
$ python main.py --messages thebigpodwithshaq --limit 3
Download images and videos from a list of post URLs:
$ python main.py --urls https://www.passes.com/thebigpodwithshaq/fb697c54-2f63-41f0-bdbe-9afd95026566 https://www.passes.com/thebigpodwithshaq/619074e2-22e2-4a70-8bf0-13ae0d2da33e https://www.passes.com/texasonefund/71d233df-0091-4149-8cdf-2f3b6789c07f
Download videos from a file containing a list of post URLs:
$ python main.py --file urls.txt --videos
urls.txt:
https://www.passes.com/thebigpodwithshaq/fb697c54-2f63-41f0-bdbe-9afd95026566
https://www.passes.com/thebigpodwithshaq/619074e2-22e2-4a70-8bf0-13ae0d2da33e
https://www.passes.com/thebigpodwithshaq/d189dcaf-b069-4fa1-b6bd-fa2d54172059
https://www.passes.com/texasonefund/71d233df-0091-4149-8cdf-2f3b6789c07f
Download images from posts in a user's feed from a specific time range:
$ python main.py --feed texasonefund --images --from 2024-07-01T00:00:00 --to 2024-08-31T23:59:59