Skip to content

Latest commit

 

History

History
115 lines (71 loc) · 6.3 KB

README.md

File metadata and controls

115 lines (71 loc) · 6.3 KB
Raw

MediaDL

MediaDL

Install MediaDL Release GitHub Issues GitHub Pull Requests

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
  • 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 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 from the App Store.

  3. Add the MediaDL 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 https://github.com/imputnet/cobalt#ethics-and-disclaimer and refined a bit.

Contribute 💡

Check the Contribution Guide 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.