Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/p1atdev/twimedia-wizard
Twitter Media Downloader
https://github.com/p1atdev/twimedia-wizard
cliffy deno twitter twitter-media
Last synced: 6 days ago
JSON representation
Twitter Media Downloader
- Host: GitHub
- URL: https://github.com/p1atdev/twimedia-wizard
- Owner: p1atdev
- License: mit
- Created: 2022-12-21T20:19:52.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2023-06-13T09:31:16.000Z (over 1 year ago)
- Last Synced: 2024-11-22T00:48:06.864Z (about 2 months ago)
- Topics: cliffy, deno, twitter, twitter-media
- Language: TypeScript
- Homepage:
- Size: 78.1 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TwiMedia Wizard
[](https://github.com/p1atdev/twimedia-wizard/actions/workflows/testing.yaml)
[](https://codecov.io/gh/p1atdev/twimedia-wizard)
Twitter media donwloader.
You need [Deno](https://deno.land/[email protected]/getting_started/installation) to use.
## Deno installation
- macOS or Linux
```bash
curl -fsSL https://deno.land/x/install/install.sh | sh
```
- Windows
```
scoop install deno
```
# Usage
Clone repository and build
```bash
git clone https://github.com/p1atdev/twimedia-wizard.git
cd twimedia-wizard
deno task build
```
then `twimedia.exe` (or `twimedia`) will be generated to project root.
## Help
```bash
twimedia --help
```
`--help` or `-h`
## User
Specifying user to download.
```bash
twimedia user TWITTER_USER_ID --max 50 -o ./output
```
- -h, --help - Show this help.
- -o, --output - Output path. (required)
- -m, --max - Maximum number of media to download. Default is 5000
- -d, --dump [boolean] - Dump information to a json file.
## Search (deprecated)
This method is not working now.
Specifying search query to search and download.
```bash
twimedia search SEARCH_QUERY -o ./output
```
- -h, --help - Show this help.
- -o, --output - Output path. (required)
- -m, --max - Maximum number of media to download. Default is 5000
- -l, --latest - Download media from Latest tweets. If not specified, it will download media from Top tweets.
- -d, --dump [boolean] - Dump information to a json file.
## List
Specifying list id to download.
```bash
twimedia list TWITTER_LIST_ID --max 50 -o ./output
```
- -h, --help - Show this help.
- -o, --output - Output path. (required)
- -m, --max - Maximum number of media to download. Default is 5000
- -d, --dump [boolean] - Dump information to a json file.
## Download
Download from dumped json.
```bash
twimedia download path/to/json -o ./output
```
- -h, --help - Show this help.
- -o, --output - Output path. (required)
- --min-favorites - Minimum number of favorites to download. (Default: 10)
- --min-retweets - Minimum number of retweets to download. (Default: 0)
- --caption [boolean] - Download captions. (Default: false)
# TODO
- [-] Filtering with likes. (only works with dumped json)