KarmaFinder

A fast & responsive browser-based Reddit client with semantic search, bookmark features, advanced filters, themes and more.

Live Site: https://karmafinder.site/

Demo Video:

demo.mp4

Section analytics and metadata

• Track creation date, bookmark count, top subreddit, and last modified with custom descriptions for organizing collections.
• Generate public links to share curated bookmark collections with anyone, no login required.

trimmed2.mp4

Imports

• Import Reddit saves instantly using OAuth single click login.
• See number of unique posts.
• Saves populate in order to any section.

Bookmarks

• Move any post with dropdown menu.
• Organize posts inside custom sections with drag-and-drop.
• Choose emoji, rename, and delete sections.

Search

• Enhanced Search: semantic search with vector embeddings using Pinecone, query matching and algorithmic ranking.
• Smart filtering with progressive fetch - batch filter by content type (video/image/text, time period).
• Combine filters Reddit doesn't allow (hot + past week, etc.).
• Dynamic search suggestions with spell check from dictionary, word completion API, and user input.

Media

• Plyr.io player for smooth playback on Reddit video: ffmpeg merges audio/video streams and caches on a local CDN.
• YouTube and Streamable embeds.
• Modal viewer with zoom and smooth gallery navigation with preloading & decoding for seamless transitions.
• Markdown and image support in comments.

UI

• Multiple themes (Forest, Bluebird, dark, light).
• Configurable layouts: Comfy and Compact modes for different card sizes.
• Top 8 comments on every post without clicking through.
• Hermes - animated kitty mascot with 100+ unique contextual responses.

Misc Features

• Batch rendering for performance, caching for quick responses, minimal API load.
• Passwordless magic link login (login optional).
• NSFW blur filter with pattern detection.

Install

Local Installation

git clone https://github.com/hawaiichair23/karmafinder.git
cd karmafinder
npm install
node server.js

Open http://localhost:3000

Configuration

Create a .env file in the root directory with the following variables:

Required

# Postgres Database
PGUSER=your_postgres_user
PGHOST=localhost
PGDATABASE=whatever
PGPASSWORD=your_postgres_password
PGPORT=5432

# Email Magic Links - for login
RESEND_API_KEY=your_resend_api_key

# Reddit API
REDDIT_CLIENT_1_ID=your_reddit_client_id
REDDIT_CLIENT_1_SECRET=your_reddit_client_secret
REDDIT_USER_AGENT_1=KarmaFinder/1.0 by /u/yourusername

# Reddit OAuth (for importing saves)
REDDIT_WEBAPP_SECRET=your_reddit_webapp_secret
REDDIT_WEBAPP_CLIENT=your_reddit_webapp_client

Optional

# Vector Search (Pinecone)
PINECONE_API_KEY=
PINECONE_ENVIRONMENT=

# Caching (Redis)
REDIS_API_KEY=
REDIS_ENDPOINT=