https://github.com/magicoflolis/magic-ph
A video downloader for various adult websites
https://github.com/magicoflolis/magic-ph
browser-extension greasymonkey pornhub tampermonkey userscript web-extension webextension
Last synced: 17 days ago
JSON representation
A video downloader for various adult websites
- Host: GitHub
- URL: https://github.com/magicoflolis/magic-ph
- Owner: magicoflolis
- License: mit
- Created: 2020-03-26T18:57:32.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2025-03-13T17:41:15.000Z (about 1 month ago)
- Last Synced: 2025-04-06T06:06:35.198Z (18 days ago)
- Topics: browser-extension, greasymonkey, pornhub, tampermonkey, userscript, web-extension, webextension
- Language: JavaScript
- Homepage:
- Size: 11 MB
- Stars: 104
- Watchers: 7
- Forks: 12
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
---
MagicPH
> [!IMPORTANT]
> This userscript / webextension violates [websites](https://github.com/magicoflolis/Magic-PH/blob/master/pages.md) content policies on `Banning Downloads`.
>
> **PLEASE USE AT YOUR OWN RISK!**
_Recommend using "ad blocker" or "content blocker" ([uBlock Origin](https://github.com/gorhill/uBlock#readme)) along side._
A video downloader for various adult websites. _WebExtension version has not been updated in a while, please use UserScript version!_
[UserScript Changelog](https://github.com/magicoflolis/Magic-PH/blob/master/CHANGELOG.user.md)
**Supported Websites:** - [List of policy violations](https://github.com/magicoflolis/Magic-PH/blob/master/pages.md)
| Websites | Version (Desktop) | Version (Mobile) |
| :-----------------------------------------------: | :---------------: | :--------------: |
| [Beeg](https://beeg.com) | ✅ | ✅ |
| [Onlyfans](https://onlyfans.com) | ✅ | ✅ |
| [Pornhub](https://www.pornhub.com) | ✅ | ✅ |
| [Pornhub Premium](https://www.pornhubpremium.com) | ✅ | ✅ |
| [RedTube](https://www.redtube.com) | ✅ | ✅ |
| [Tube8](https://www.tube8.com) | ✅ | ✅ |
| [Thumbzilla](https://www.thumbzilla.com) | ✅ | ✅ |
| [xHamster](https://xhamster.com) | ✅ | ✅ |
| [XNXX](https://www.xnxx.com) | ✅ | ✅ |
| [xVideos](https://www.xvideos.com) | ✅ | ✅ |
| [YouPorn](https://www.youporn.com) | ✅ | ✅ |
---
## **Download**
**UserScript:**
- [Sleazy Fork](https://sleazyfork.org/scripts/492700)
- [GitHub Repo](https://github.com/magicoflolis/Magic-PH/raw/master/dist/magicph.user.js)
- [Open UserJS](https://openuserjs.org/scripts/Magic/MagicPH) - outdated
**Web Extension (under construction):**
_Firefox:_
- ~~[GitHub Repo](https://github.com/magicoflolis/Magic-PH/releases)~~
_Chromium:_
- ~~[GitHub Repo](https://github.com/magicoflolis/Magic-PH/releases)~~
**Bookmarklet (not recommended):**
Save this URL as a bookmark, clicking it will cause the **UserScript version** to inject itself into the current webpage.
```js
javascript: (function () {
['https://cdn.jsdelivr.net/gh/magicoflolis/Magic-PH@master/dist/magicph.user.js'].map(
(s) => (document.body.appendChild(document.createElement('script')).src = s)
);
})();
```
## Features
> See [Accessing Downloader](#accessing-downloader)
- General:
- UI designed for mobile and desktop devices
- Will match the websites theme.
- Built in tabs feature.
- Built in video downloader allows user to easily download and save any video in its highest quality or preferred choice.
- Video downloader can be combined with any 3rd party/external downloader.
## Previews
## Accessing Downloader
**Default Method:**
- Click "**Show List**" located to the bottom right of the page.
- Onlyfans (**Mobile**) - Click on any video post.
**Website Specific:**
- Desktop / Mobile - Right click anywhere inside the video player then click "**Video Quality(s)**".
- Mobile - Press "**Video Quality(s)**" in the video player.
- Mobile (**Alternative**) - Press the gear icon in the video player.
- Youporn (**Mobile**) - Press the gear icon in the video player then press "**Video Quality(s)**".
## Tabs
> In a nutshell, the tab system work the same way your browser creates tabs, by default the tab is named after the host.
A new tab is automatically created when a video source is found, the tab is named after the videos title.
**Creating a New Tab:**
> Creating a new tab is as easy as clicking the "+" within the list.
This new tab is a search box, typing any supported method will automatically find the video source(s)!
Supported Methods:
- `` of any supported website or `/`
- Beeg (**Not Supported**) - _Still a work in progress_
- Onlyfans (**Must be on the same website**) - _Still a work in progress_, `/` or `//photos|videos|audios|likes|streams|upcoming-streams`.
- Pornhub - `/view_video.php?viewkey=` or just entering the ``.
- RedTube - `/`
- Tube8 - `/porn-video//`
- Thumbzilla - `/video//`
- xHamster (**Work in Progress**) - `/videos/`
- XNXX (**Work in Progress**) - `/video-/`
- xVideos - `/video./`
- Youporn (**Work in Progress**) - `/watch///`
## Build
Install [Node.js](https://nodejs.org/) and [pnpm](https://pnpm.io/). _The version of Node.js should match or be greater than the `"node"` key in `package.json`._
```sh
# Install dependencies
$ pnpm i
```
**Additional Help Links:**
- [web-ext](https://extensionworkshop.com/documentation/develop/getting-started-with-web-ext/)
- [key.pem for Chrome](https://stackoverflow.com/a/46739698/9872174)
**External Libraries:**
- [Plyr](https://github.com/sampotts/plyr)
---
**UserScript:**
Before you begin, rename `.env.example` to `.env`
**Recommened Testing Environments:**
- **Desktop:** any browser with [ViolentMonkey](https://violentmonkey.github.io/), see [How to edit scripts with your favorite editor?](https://violentmonkey.github.io/posts/how-to-edit-scripts-with-your-favorite-editor/)
- **Mobile:**
- Desktop: use "Responsive Design Mode (Ctrl+Shift+M)" on [FireFox Developer Edition](https://www.mozilla.org/firefox/developer/) or [FireFox](https://www.mozilla.org/firefox/)
- Android: any browser with UserScript support or support for installing a UserScript manager, I use [Cromite](https://github.com/uazo/cromite)
- IOS: any browser with UserScript support or support for installing a UserScript manager
```sh
# Watch and build to local HTTP server
$ pnpm run dev:UserJS
# Build UserScript to "./dist"
$ pnpm run pub:UserJS
```
### Roadmap
- Finish WebExtension version.
- Fix any bugs along the way.
### Source Code
- [https://github.com/magicoflolis/Magic-PH](https://github.com/magicoflolis/Magic-PH)