Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/plbstl/mediadl

🎬 One-click media downloader for iOS and iPadOS, available in your ShareSheet. Powered by Siri Shortcuts & Scriptable.
https://github.com/plbstl/mediadl

Last synced: 5 days ago
JSON representation

🎬 One-click media downloader for iOS and iPadOS, available in your ShareSheet. Powered by Siri Shortcuts & Scriptable.

Awesome Lists containing this project

README 

        



![MediaDL](square.and.arrow.down.fill.png)



# MediaDL



[![Install MediaDL][install-badge]][install-link]

[![Release][gh-release-badge]][gh-release-link]

[![GitHub Issues][gh-issues-badge]][gh-issues-link]

[![GitHub Pull Requests][gh-pulls-badge]][gh-pulls-link]









There are **_no ads, unnecessary prompts, tracking or third-party involved_**; everything is **_executed on-device_** and you never have to leave the currently opened application.






## Supported platforms ✅



- [ ] Facebook

- [x] Instagram (requires sign-in)

- [ ] Pinterest

- [ ] Reddit

- [ ] Snapchat

- [ ] Threads

- [ ] TikTok

- [ ] Tumblr

- [ ] Twitch

- [ ] Vimeo

- [ ] X (formerly Twitter)

- [ ] YouTube



## How to use 🎛️



1. **Share a post:** Click on the relevant Share post icon in the application you're in, to bring up the ShareSheet.



2. **Share to MediaDL:** When the ShareSheet shows, scroll until you find the MediaDL option, then choose it. The first attempt requires you to grant MediaDL permissions to make requests, read through it and click Always Allow.



3. **Continue:** Just like that, MediaDL starts working and you can continue using the application. Prompts to select media might popup if you're downloading multiple items at once.



4. **Media saved:** A visual loader shows the progress and when its done, the file will have been downloaded and placed in the relevant location in your device.



MediaDL works in browsers too.



## Installation 📲



1. The Shortcuts app comes preinstalled on Apple devices. In the case that yours is deleted, install [Shortcuts][shortcuts-app-link] from the App Store.

2. Scriptable is used for functionality not yet available in the Shortcuts app. Just like Shortcuts app, you can use it for a lot of other things. Install [Scriptable][scriptable-app-link] from the App Store.

3. Add the [MediaDL][mediadl-shortcut-link] shortcut to your Shortcuts library.

4. Attempt to download media from a supported platform of your choice.



   > If the platform requires you to sign in, **Scriptable** will open a WebView for you to sign in. Sign in and close Scriptable. Future downloads from the selected platform should complete from now on.



5. Select `Always Allow` when prompted for network access to avoid prompts every time you use MediaDL.



## Important Notes 🗒️



- MediaDL will **_never ask_** for your username/email or password. You will be presented with a WebView to login into the relevant official platform using their official methods.



- When using mobile data to access the internet, mobile data has to be turned on for both **Shortcuts** & **Scriptable** in your device settings for downloads to work.



- You have to be signed in to the specific platform to access media private to you.



- You may not have access to sensitive/NSFW content without being signed in to the specific platform.



## Ethics and Disclaimer ⚠️



MediaDL is a tool designed to simplify content downloads from the internet, with **_zero liability_**. You are responsible for what you download, how you use, and distribute that content. Please be mindful of using others’ content and always credit the original creators. Fair use and proper credits benefit everyone.



**MediaDL is NOT a piracy tool** and cannot be used as such. It only downloads free, publicly accessible content, which can also be downloaded through any browser’s developer tools. This tool offers a **convenient**, **clutter-free**, **one-click solution** for repetitive actions.



> This section is gotten from  and refined a bit.



## Contribute 💡



Check the [Contribution Guide](./CONTRIBUTING.md) for how to contribute to this project.



## License 🤝



MediaDL is licensed under CC BY-NC-SA 4.0



**You are free to:**



- **Share** — copy and redistribute the material in any medium or format.



- **Adapt** — remix, transform, and build upon the material.



**Under the following terms:**



- **Attribution** — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.



- **NonCommercial** — You may not use the material for commercial purposes.



- **ShareAlike** — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.



- **No additional restrictions** — You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.



[gh-issues-badge]: https://img.shields.io/github/issues/plbstl/MediaDL

[gh-issues-link]: https://github.com/plbstl/MediaDL/issues

[gh-pulls-badge]: https://img.shields.io/github/issues-pr/plbstl/MediaDL

[gh-pulls-link]: https://github.com/plbstl/MediaDL/pulls

[gh-release-badge]: https://img.shields.io/github/v/release/plbstl/MediaDL?sort=semver

[gh-release-link]: https://github.com/plbstl/MediaDL/releases

[install-badge]: https://img.shields.io/badge/install_MediaDL-7c3aed?style=flat-square

[install-link]: https://plbstl.github.io/MediaDL/install



[mediadl-shortcut-link]: https://www.icloud.com/shortcuts/b0792743b4694f28a246f8a31336c960

[scriptable-app-link]: https://apps.apple.com/app/scriptable/id1405459188

[shortcuts-app-link]: https://apps.apple.com/app/shortcuts/id915249334