https://github.com/Sibusten/derpibooru-downloader

A downloader for imageboards running Philomena, such as Derpibooru.
https://github.com/Sibusten/derpibooru-downloader

booru derpibooru downloader image imagebooru images philomena

Last synced: about 2 months ago
JSON representation

A downloader for imageboards running Philomena, such as Derpibooru.

• Host: GitHub
• URL: https://github.com/Sibusten/derpibooru-downloader
• Owner: Sibusten
• License: mit
• Created: 2017-02-13T22:48:44.000Z (over 7 years ago)
• Default Branch: main
• Last Pushed: 2023-02-24T16:34:57.000Z (over 1 year ago)
• Last Synced: 2024-02-09T03:03:24.194Z (5 months ago)
• Topics: booru, derpibooru, downloader, image, imagebooru, images, philomena
• Language: C#
• Homepage:
• Size: 785 KB
• Stars: 57
• Watchers: 13
• Forks: 6
• Open Issues: 19
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Lists

• awesome-booru - derpibooru-downloader - Downloads images from derpibooru.org using a variety of options (Software / Clients)

README

        
# Philomena Downloader

[![CI](https://github.com/Sibusten/derpibooru-downloader/actions/workflows/ci.yml/badge.svg)](https://github.com/Sibusten/derpibooru-downloader/actions/workflows/ci.yml)

[![GitHub release (latest SemVer including pre-releases)](https://img.shields.io/github/v/release/Sibusten/derpibooru-downloader?include_prereleases)](https://github.com/Sibusten/derpibooru-downloader/releases)

A downloader for imageboards running [Philomena](https://github.com/derpibooru/philomena), such as [Derpibooru](https://derpibooru.org).

**NOTE:** Philomena Downloader v3.0.0 is currently in alpha. Data may not migrate nicely between versions just yet. The documentation for v2.1.0 can be found in the [v2.1.0 branch](https://github.com/Sibusten/derpibooru-downloader/tree/release-v2.1.0)

## Install .NET 5

This program requires the [.NET 5.0 runtime](https://dotnet.microsoft.com/download/dotnet/5.0/runtime/).

[`dotnet-install`](https://docs.microsoft.com/en-us/dotnet/core/tools/dotnet-install-script) is an alternative, and may be easier for some Linux users: `sudo bash dotnet-install.sh -c 5.0 --runtime dotnet --install-dir /usr/share/dotnet`

## Booru Setup

Boorus must be set up before downloading images. They require a name and the base URL of the booru. For example, to add [Derpibooru](https://derpibooru.org):

`philomena-downloader booru add derpibooru https://derpibooru.org`

## Usage

![Usage](Screenshots/usage.gif)

Run `philomena-downloader download --help` for a list of available options

## Presets

Presets can be set up for commonly used search options. They require a name and the options to use. The options are the same as they are for downloading. For example, to create a preset for the query in the usage gif:

`philomena-downloader preset add fluttershy --boorus derpibooru ponybooru --query fluttershy --limit 20`

Presets can be updated as well:

`philomena-downloader preset update fluttershy --sort-field Score`

Using a preset:

`philomena-downloader download --preset fluttershy`

Any other options given when downloading with a preset will override options in the preset. For example, this will use all options from the `fluttershy` preset, but download 100 images per booru instead:

`philomena-downloader download --preset fluttershy --limit 100`