base on Downloads albums from the web in bulk for archive purposes # RipMe [](/LICENSE.txt) [](https://gitter.im/RipMeApp/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [](https://www.reddit.com/r/ripme/)  [](https://coveralls.io/github/RipMeApp/ripme?branch=main) ## About RipMe is an album downloader (or "ripper") for various websites. This is a cross-platform tool that runs on *your* computer. Works on Windows, Linux, and Mac.  ## Download Download `ripme.jar` from the [latest release](https://github.com/ripmeapp/ripme/releases/latest). For information about running the `.jar` file, see [the How To Run wiki](https://github.com/ripmeapp/ripme/wiki/How-To-Run-RipMe). ## Minimum Requirements Requires Java 17 or later to run. RipMe has been tested on and is confirmed working on Windows, Linux, and Mac. Java 17 is the most modern possible Java version that allows us to support the most platforms. See [thread](https://github.com/RipMeApp/ripme/pull/2057#issuecomment-2571472016). ## Supported Sites Jump to: - [List of Supported Sites](https://github.com/RipMeApp/ripme?tab=readme-ov-file#list-of-supported-sites) - [Site Not Supported?](https://github.com/RipMeApp/ripme?tab=readme-ov-file#site-not-supported) ## Recent development updates - The current active development repo for RipMe is located at [ripmeapp/ripme](https://github.com/ripmeapp/ripme/). - Note: For a while, the ripmeapp/ripme repo was inactive, but development continued at ripmeapp2/ripme. - Now, maintainers have been updated and development has been rejoined with ripmeapp/ripme where it will continue. - You may find a number of stale issues on ripmeapp/ripme and/or on ripmeapp2/ripme until everything is merged back together and statuses are updated. ## Maintainers RipMe has been maintained with ♥️ and in our limited free time by the following people, with current expected activity level marked by color of the indicator: - **[@MetaPrime](https://github.com/metaprime)** 🟡 (2025–present) - **[@soloturn](https://github.com/soloturn)** 🟡 (2021–present) - **[@cyian-1756](https://github.com/cyian-1756)** 🟥 (2017–2020) - **[@kevin51jiang](https://github.com/kevin51jiang)** 🟥 (2017–2018) - **[@MetaPrime](https://github.com/metaprime)** 🟡 (2016–2017) - and its original creator, **[@4pr0n](https://github.com/4pr0n)** 🟥 (2014–2016) If you'd like to become a maintainer, reach out on https://gitter.im/RipMeApp/Lobby and ask an active maintainer to be added to the team. ## Contact Chat with the team and community on [gitter](https://gitter.im/RipMeApp/Lobby) and [reddit.com/r/ripme](https://www.reddit.com/r/ripme/) ## Version Numbers The version number like `ripme-1.7.94-17-2167aa34-feature_auto_release.jar` contains a release number (`1.7.94`), given by a person, the number of commits since this version (`17`). The commit SHA (`2167aa34`) uniquely references the source code ripme was built from. If it is not built from the main branch, the branch name (`feature/auto-release`) is given. Note that this follows the Semantic Versioning spec (see https://semver.org/), and uses the feature of the format that adds extra data after the `-` to provide helpful context so that every commit on every branch has a dintinct semver version associated with it. ## Installation On macOS, there is a [cask](https://github.com/Homebrew/homebrew-cask/blob/master/Casks/ripme.rb). ``` brew install --cask ripme && xattr -d com.apple.quarantine /Applications/ripme.jar ``` ## Changelog [Changelog](/ripme.json) **(ripme.json)** # Features - Quickly downloads all images in an online album. [See supported sites](https://github.com/ripmeapp/ripme/wiki/Supported-Sites) - Easily re-rip albums to fetch new content - Built in updater - Skips already downloaded images by default - Can auto skip e-hentai and nhentai albums containing certain tags. [See here for how to enable](https://github.com/RipMeApp/ripme/wiki/Config-options#nhentaiblacklisttags) - Download a range of urls. [See here for how](https://github.com/RipMeApp/ripme/wiki/How-To-Run-RipMe#downloading-a-url-range) ## List of Supported Sites See the full list of [Supported Sites](https://github.com/ripmeapp/ripme/wiki/Supported-Sites) in the wiki. Note: Websites change over time and therefore rippers, which fundamentally depend on website layouts, can break at any time. Feel free to open an issue if you notice something not working, but please search the list of issues to see if it's already been reported. The list of supported rippers includes: - imgur - twitter (currently broken, needs to be updated for X) - tumblr - instagram - flickr - photobucket - reddit - redgifs - motherless - imagefap - seenive - 8muses - deviantart (currently broken by major changes to the site) - xhamster - xvideos - ... and [more](https://github.com/ripmeapp/ripme/wiki/Supported-Sites)! ## Site Not Supported? Request support for more sites by adding a comment to [this Github issue](https://github.com/RipMeApp/ripme/issues/2068). If you're a developer, you can add your own Ripper by following the wiki guide: [How To Create A Ripper for HTML Websites](https://github.com/ripmeapp/ripme/wiki/How-To-Create-A-Ripper-for-HTML-websites). # Maintainers ## Compiling & Building The project uses [Gradle](https://gradle.org). In particular, we use the `gradlew` script (`gradlew.bat` on Windows) to build the app and run tests. To build the .jar file and run the appropriate tests, navigate to the root project directory and run `gradlew` with the appropriate commands (see below). Ensure that you manually test that your change works, add or update the corresponding test, and run at least the test(s) that are relevant to your change. For example, if you modify the Xhamster ripper, you might run this or a similar command: ``` ./gradlew clean build testAll --tests XhamsterRipperTest.testXhamster2Album ``` Here's a breakdown of the functionality of the `gradlew` scripts: The `build` verb will build the `.jar`, the tests, and will also *run* the tests ,except for disabled and flaky tests. Thus `build` and `build test` are actually synonymous. ```bash ./gradlew build ./gradlew build test ``` You can get more specific with your test commands: ```bash ./gradlew clean build testAll --tests XhamsterRipperTest.testXhamster2Album ./gradlew clean build -x test --warning-mode all ``` To perform a clean rebuild, which is only necessary to see warnings for unchanged files or if you believe that the incremental build is interfering with the build picking up your changes, for example. That shouldn't be an issue for gradle, so you should check for easier explanations like whether you saved your changes. :) ```bash ./gradlew clean ``` To build ("assemble") the .jar without running the tests, which is useful for manual verification of functionality of a work in progress, run the following: ```bash ./gradlew assemble ``` The generated JAR (java archive) in build/libs will include all dependencies. ## Running Tests Tests can be tagged as beeing slow, or flaky. The gradle build reacts to the following combinations of tags: - default is to run all tests without tag. - testAll runs all tests. - testFlaky runs tests with tag "flaky". - testSlow runs tests with tag "slow". - tests can be run by test class, or single test. Use "testAll" so it does not matter if a test is tagged or not. - tests can give the full stack of an assertion, exception, or error if you pass `--info` to the command ```bash ./gradlew test ./gradlew testAll ./gradlew testFlaky ./gradlew testSlow ./gradlew testAll --tests XhamsterRipperTest ./gradlew testAll --tests XhamsterRipperTest.testXhamster2Album ./gradlew testAll --tests ChanRipperTest --info ``` Please note that some tests may fail as sites change and our rippers become out of date. Start by building and testing a released version of RipMe and then ensure that any changes you make do not cause more tests to break. ## Maintainers: How to Publish a New Release See wiki: [How to Make a New Ripme Release](https://github.com/RipMeApp/ripme/wiki/How-to-make-a-new-ripme-release) ", Assign "at most 3 tags" to the expected json: {"id":"12628","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"