Skip to content

BooruRamen is a personalized booru browser that learns what you love. It uses a client-side recommendation algorithm to deliver a unique, curated feed of images and videos that improves the more you use it.

License

Notifications You must be signed in to change notification settings

SoupDevs/BooruRamen

BooruRamen Banner

License

Overview

BooruRamen is a personalized booru browser that learns what you love. It uses a client-side recommendation algorithm to deliver a unique, curated feed of images and videos that improves the more you use it.

BooruRamen Banner Example 1
BooruRamen Banner Example 2

Key Features

  • Adaptive Feed: A TikTok-style scroll that learns what you like in real-time.
  • Total Privacy: No servers. No tracking. Your history stays on your device.
  • All-in-One: Seamlessly browse sites running on Danbooru and Gelbooru engines in a single app.
  • Immersive Player: Cinema-style viewer with custom controls for HD video & art.
  • Profile Stats: Charts and graphs that visualize your unique taste.

Recommendation System

BooruRamen uses a sophisticated recommendation system that:

  • Analyzes your browsing patterns
  • Learns from your likes, dislikes, favorites, and watchtime.
  • Builds a personalized content profile
  • Delivers a unique feed based on your preferences

All recommendations are processed locally in your browser for privacy.

Profile Analytics

Gain insights into your preferences with the dedicated Analytics page:

  • Top Tags & Pairs: See which content you engage with most.
  • Engagement Metrics: Track Like and Favorite rates normalized by views.
  • Most Disliked: Identify tags you frequently dislike to refine recommendations.
  • Video Analytics: Monitor your total video watch time and average viewing duration.
  • Visualizations: View tag distributions via responsive SVG-based charts.

Getting Started

Windows

  1. Download: Get the .exe from the latest Releases.
  2. Run: Double-click the .exe file to start the app.

Linux

  1. Download: Get the .AppImage or .deb from the latest Releases.
  • For AppImage:
bash
chmod +x BooruRamen.AppImage
./BooruRamen.AppImage
  • For Debian/Ubuntu:
bash
sudo dpkg -i BooruRamen.deb

Android

  1. Download: Get the .apk from the latest Releases.
  2. Install: Open the .apk file and follow the installation prompts.

Running from Source

Prerequisites

  • Node.js (v14 or newer)
  • npm or yarn

Installation

  1. Clone the repository:
git clone https://github.com/SoupDevs/BooruRamen.git
cd BooruRamen
  1. Install dependencies:
npm install
  1. Start the development server:
npm run dev
  1. Open your browser and navigate to:
http://localhost:5173

Building

  1. Clone the repository:
git clone https://github.com/SoupDevs/BooruRamen.git
cd BooruRamen
  1. Install Dependencies
npm install
  1. Build the Desktop App

This will compile the frontend and the Rust backend, then package them into an installer.

npm run tauri build
  1. Build for Android (Optional)
  • Requires:
    • Java Development Kit (JDK)
    • Android Studio
npm run tauri android build -- --apk true

About

BooruRamen is a personalized booru browser that learns what you love. It uses a client-side recommendation algorithm to deliver a unique, curated feed of images and videos that improves the more you use it.

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Sponsor this project

Contributors 3

  •  
  •  
  •  

Languages