booru-uploader-ts

A command-line tool for scraping various sites and uploading images to Derpibooru.

Derpibooru topic: https://derpibooru.org/forums/meta/topics/my-derpibooru-uploader

Getting Started

Prerequisites

• Node.js v22+
• git

Where to type commands:

• Windows: PowerShell (or Windows Terminal, recommended)
• MacOS/Linux: Terminal

Installation

git clone https://github.com/mdashlw/booru-uploader-ts.git
cd booru-uploader-ts
npm install

Receiving updates

cd booru-uploader-ts
git pull
npm install

Setup

Rename .env.example to .env and fill in the required values.

Derpibooru

• DERPIBOORU_API_KEY - find here: https://derpibooru.org/registrations/edit

DeviantArt

1. Register an app here: https://www.deviantart.com/developers/apps
2. Fill in DEVIANTART_CLIENT_ID and DEVIANTART_CLIENT_SECRET
3. Edit your app to add http://localhost:1341/callback to "OAuth2 Redirect URI Whitelist"
4. Do npm run deviantart-oauth
5. Export your DeviantArt cookies using the instructions below

Note: Deviations will be exported to your Sta.sh storage, which may eventually run out of space. Delete them regularly.

Tumblr

1. Create an empty blog on your account (the last one in the list will be used for exporting images)
2. Export your Tumblr cookies using the instructions below

Fur Affinity

1. On https://www.furaffinity.net/controls/settings/, set Time Zone to Greenwich Mean Time and disable "Apply Daylight saving time correction"
2. Export your Fur Affinity cookies using the instructions below

How to export cookies

1. Login to the site
2. Install Get cookies.txt LOCALLY browser extension: Chrome / Firefox
3. Click on the extension icon in the browser toolbar while on the page
4. Set "Export Format" to JSON. Click "Export" or "Export As" (do not rename the file)
5. Move the file to the booru-uploader-ts folder

Others

• DISCORD_CDN_BOT_TOKEN - used for refreshing Discord CDN links. make a bot here and copy the BOT TOKEN: https://discord.com/developers/applications
• INKBUNNY_USERNAME and INKBUNNY_PASSWORD - Inkbunny username and password. optional but some submissions are member-only
• WEASYL_API_KEY - get here: https://www.weasyl.com/control/apikeys
• NEWGROUNDS_COOKIE - login to https://www.newgrounds.com/ and copy the cookie

Usage

Uploading

• npm start
• npm start 3506534 to copy sources from the specified Derpibooru image

Description

When uploading, the tool automatically generates a description from the specified sources.

Do npm run description or npm run description 3506534 to generate it manually and copy to clipboard.

Boosty (December 20, 2023 at 10:07:19 PM UTC)
> **🤍🎄**
> Looks like it's that time again where the sketch looks better than the finale 😅 
>
> Have you put up the Christmas tree yet?🎄
>
> [#zipp storm](https://boosty.to/itssim?postsTagsIds=578559) [#izzy moonbow](https://boosty.to/itssim?postsTagsIds=1626400)

Twitter (December 22, 2023 at 3:47:00 PM UTC)
> 🤍🎄
> Have you decorated your Christmas tree yet?
> \#ZippStorm \#mlpgen5 \#mlpg5 \#IzzyMoonbow

DeviantArt (January 8, 2024 at 10:51:01 AM UTC)
> **Zippmas tree**
>
>
> [#izzymoonbow](https://www.deviantart.com/tag/izzymoonbow) [#zippstorm](https://www.deviantart.com/tag/zippstorm)