Disclaimer: This project is not affiliated with or endorsed by Inkbunny.

Inkbunny Downloader is a desktop and terminal app for searching Inkbunny, reviewing results, and downloading files in bulk with a queue you can control.

• Search by keywords, title, description, or MD5.
• Filter by artist, favorites, time range, sort order, and submission type.
• Switch between a desktop app, terminal UI, or headless CLI workflow.
• Queue multiple downloads and control concurrent jobs.
• Save submission metadata beside downloads as .json sidecar files if you want captions.
• Reuse saved sessions so you do not need to log in every time.

The easiest way to install the downloader is from GitHub Releases:

For the desktop app, download:

• inkbunny-downloader-windows.exe

For the terminal version, download:

• inkbunny-downloader-tui-windows.exe

Suggested setup:

1. Create a folder for the app.
2. Move the downloaded .exe into that folder.
3. Run it directly.

For the desktop app, download:

• inkbunny-downloader-linux-amd64

For the terminal version, download:

• inkbunny-downloader-tui-linux-amd64

Then make it executable:

chmod +x inkbunny-downloader-linux-amd64
chmod +x inkbunny-downloader-tui-linux-amd64

Run it with:

./inkbunny-downloader-linux-amd64

or:

./inkbunny-downloader-tui-linux-amd64

1. Start the desktop app or terminal build.
2. Log in with your Inkbunny username and password, or continue as a guest.
3. Choose which content ratings you want the API session to show.
4. Pick a download folder.
5. Search, review results, select files, and enqueue downloads.

To use your own account through the API:

1. Log in on Inkbunny.
2. Open Account Settings.
3. Enable API access.
4. Return to the downloader and sign in.

The desktop app is the main end-user experience. It gives you:

• Search forms with filters and autocompletion.
• A visual results grid with previews.
• A download queue panel with progress tracking.
• Download folder, theme, motion, and concurrency settings.

Launch the desktop app by starting the desktop release binary with no extra setup.

The TUI is useful if you want an interactive workflow without the desktop shell.

On Windows:

.\inkbunny-downloader-tui-windows.exe

On Linux:

./inkbunny-downloader-tui-linux-amd64

If you prefer scripts or one-shot commands, you can pass flags and run headless.

Example:

inkbunny-downloader-tui-linux-amd64 --search "fox -comic" --artist "artist_name" --order favs --limit 25 --username "Elly" --password "hunter2" --caption

Or reuse an existing session without passing a password:

inkbunny-downloader-tui-linux-amd64 --sid "abc123" --search "fox -comic" --artist "artist_name" --order favs --limit 25

Useful flags:

• --username username for non-interactive login
• --password password for non-interactive login
• --sid existing session ID for non-interactive login; overrides username/password
• --search search text, including exclusions like tag -excludedtag
• --join combine terms with and, or, or exact
• --in choose search fields such as keywords,title,description,md5
• --artist limit results to one artist
• --favby search work favorited by a user
• --time limit results to the last N days
• --type choose a submission type such as pinup, sketch, or comic
• --order sort by create_datetime, favs, or views
• --limit cap how many submissions are downloaded
• --active set max concurrent downloads
• --caption save submission metadata to .json
• --tui force terminal UI mode
• --headless force non-interactive mode

Authentication notes:

• Use --username together with --password for a direct login.
• Use --sid if you already have a valid Inkbunny session ID.
• Use --username guest for guest mode without a password.

• The desktop app lets you choose a download directory in settings.
• The queue can run multiple downloads in parallel.
• Existing files are skipped where possible rather than downloaded again.
• Some submissions contain multiple files, and those are queued separately.
• If metadata saving is enabled, the app writes a sibling .json file beside the downloaded file.

If you want to build the desktop app yourself, start with a clean machine setup.

1. Install Go from https://go.dev/dl/
2. Install Bun from https://bun.sh
3. Download the source code.

If you have Git installed:

git clone https://github.com/ellypaws/inkbunny-downloader.git
cd inkbunny-downloader

If you do not have Git installed:

• On the top of the page click Code
• Click Download ZIP
• Extract the ZIP somewhere easy to find
• Open a terminal inside the extracted inkbunny-downloader folder

4. After installing Go, install the Wails CLI:

go install github.com/wailsapp/wails/v2/cmd/wails@latest

5. Install frontend dependencies:

cd app
bun install
cd ..

6. Build the desktop app:

wails build

wails build uses the app frontend configured in wails.json and produces the desktop app binary.

• Make sure API access is enabled in your Inkbunny account settings.
• Confirm your username and password are correct.
• If a saved session has expired, log out and sign in again.

• Guest access is limited.
• Log in and update your session ratings if you need access to more content categories.

• Try the TUI build first.
• If you need the desktop build, install the required GTK/WebKit runtime packages for your distribution.

• This app stores session data locally so it can restore your last session.
• Downloads may include mature content depending on the ratings you enable.
• Always follow Inkbunny's rules and the creator permissions that apply to the files you download.