RedditBooru is an image board site driven by content posted to subreddits.
Keyword search can be done and, while not as powerful as reddit's search, it's a goodly bit faster (I like to think). But, what RedditBooru provides above reddit or karmadecay is reverse image searching. This allows users to keep content reposting to a minimum. The search algorithm isn't perfect, but it works most of the time.
Content hosting through RedditBooru ensures that what's uploaded is exactly what the end users will receive, no middle-man processing, scaling, or JPEGifying in between. Additionally, the original source can be directly attributed to an image so that proper props can be given. Galleries can also be created and modified thanks to login support via reddit OAuth.
Taking advantage of the aforementioned reddit OAuth, RedditBooru allows users to vote on images right through the site's interface. Combined with the fullscreen viewer, this makes browsing many subreddits worth of images very simple (and hopefully a nicer experience).
RedditBooru is never finished! Here are some ideas that are being worked on/in the thought bucket:
- Better support for mobile devices (and maybe native apps)
- Subreddit statistics pages
- Image/gallery view statistics for users
- Leaderboards
If you're here, you know the code is completely open for anybody to hack on. Found a bug or have a great idea? Open a ticket and we'll see what can happen. Want to write that code yourself? Make a pull request! Obviously, I can't guarantee that all requests will make it to the site (gotta make sure all works, and that features won't bring the server to its knees), but I'm very much open to people contributing. For help setting up your development environment, check out the next section.
If you want to get RedditBooru up and running for yourself, follow these steps.
NOTE - As RedditBooru prepares to move towards a more modular, microservice structure, this is all highly subject to change. Currently it's a mess, and it needs to be made not a mess.
You will need the following to run RedditBooru:
- A webserver that can do URL rewriting. I personally use nginx, but anything should be fine
- PHP 7+ (it's known working on PHP 7.4). You'll also need the following modules:
- Memcache
- Imagick
- GD2
- MySQL
- curl
- json
- cli (for running cron jobs)
- composer for installing PHP packages
- MySQL/MariaDB 5.0+
- memcache
- nodejs for services and front-end build pipeline
Assuming you have all of the above:
# Get the code
git clone https://github.com/dxprog/reddit-booru.git
cd reddit-booru
# Create the backend cache directory and make it writeable
mkdir cache
chmod 777 cache/
# Install composer packages
composer install
# Install node dependencies
npm install
# Assuming you have an empty database set up, create the schema
mysql -u YOUR_USER -p -D reddit-booru < schema.sql
# Build front end files
npm run buildRedditBooru can be setup to run multiple frontends with a single backend (though some work is still needed). Given that, there are two configuration files:
config.php: This is the backend config which configures "global" things like database, AWS/S3 credentials, etc. Checkoutconfig.sample.phpfor more info.app-config.php: The configuration file for a frontend, things like images URL, image storage location, etc. Checkoutapp-config.sample.phpfor more info.
You can happily run the entirety of RedditBooru from the same directory. If you want split up backend and front-end, here's what you need to know:
api/cache/- Writable directory for temporary image cache. This can be symlinked to the thumbnail cache on the front end.config/controller/cron/lib/node_modules/- You can copy this folder directory, or copypackage.jsonand runnpm installservices/vendor/- You can copy this folder directly, or copycomposer.jsonand runcomposer installviews/config.php
static/app-config.phpindex.phpupload.php- Deprecated. To be removed soon
RedditBooru expects the entire URL path to be passed in as the query string parameter _q and handles additional query string paremeters/routing itself. Example of nginx setup:
location / {
try_files $uri $uri/ /index.php?_q=$uri;
}
Sadly, this is a very manual process currently, requiring direct entry into the database. It's not difficult, just tedious. Here's what you need to know about the fields:
source_name- The name of the subreddit (including the r/). Ex:r/picssource_baseurl- (DEPRECATED) Full URL path to the subreddt. Ex:http://www.reddit.com/r/picssource_type- Type of source. The only currently supported option issubreddit. This will probably be deprecated and removed in the future.source_enabled- Whether this source is enabled.1for enabled,0for disabled. Disabled sources will not be displayed nor processed.source_subdomain(OPTIONAL) The subdomain where this can be directly accessed. Ex:pics-> pics.redditbooru.comsource_generate_report- Whether the stats bot will generate a monthly report for this subreddit.1for enabled,0for disabled.source_content_rating- (DEPRECATED) Not used anymore and will be removed in the future.source_repost_check- Whether to have the bot check for reposts and report/comment on them.0is disabled, any other number is the number of seconds in which reposting is not allowed. Ex:86400-> don't allow reposts for one day.
Content is inserted in one of two ways:
To manually update content, run the following from the backend directory:
php cron/cron.php --source=SOURCE_IDThis will scan that source and update/insert the latest 100 items. This can be run as a cron job for continual updates.
The set-it-and-forget-it node script to continually updates all enabled sources. Using either screen (or some other detached-like terminal) or something like forever, run:
node services/task-runner.jsThis service does currently have a hard coded URL to the API that returns all sources. Locate http://redditbooru.com/sources/ in task-runner.js and replace with the appropriate path. THIS IS GOING TO BE REPLACED WITH EXTERNAL SERVICE NODES VERY SOON!
There are some additional services rolled up into the main RedditBooru codebase. It's all very hacked together, so please excuse the mess.
The SauceNao service is a node script that manages requests for getting image sources via SauceNao without going over API limits. To get it running:
# SauceNao API key
export SVC_SAUCENAO_KEY = SAUCENAO_API_KEY
# Port to run the service on. SAUCENAO_PORT in config.php should be this same value. Someday, it'll use the env var too.
export SVC_SAUCENAO_PORT = 4444
# Run it. Use screen/forever/init.d script to persist
node services/saucenao-service.jsUsed to remove old cached files. It's recommended that you use find on a cron job instead.
"ai-tan" provides a couple of features on two different scripts:
cron/repost_check.php- checks new posts to see if they're reposts (as dictated by the source'ssource_repost_check)cron/ai-tan.php- generates and posts montly report of a source's activity (as dictated by the source'ssource_generate_report)
These scripts rely on an old PHP based reddit framework of mine that's terrible and outdated. Setting this up is non-trivial and won't be covered here as they are actively being replaced by better, stand-alone modules.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent
