Skip to content

reddit-pfp-maker is a lightweight tool to generate profile pictures for Reddit (and other platforms). It’s designed to be: Easy to use — minimal setup, clear defaults. Customizable — templates, text, colors, and export options. Accessible — keyboard-friendly and clear contrast by default.

License

Notifications You must be signed in to change notification settings

DisabledAbel/reddit-pfp-maker

Repository files navigation

Reddit Profile Picture Converter

Make a perfect Reddit avatar in seconds. Upload any image, crop to a circle, optionally remove the background with on-device AI, and export a crisp 256×256 WebP under 200KB.

Features

  • Drag & drop or file picker upload
  • Round crop with live preview (react-easy-crop)
  • Zoom via slider (scroll/pinch zoom disabled for precision)
  • One-click "Make it fit" centered square crop
  • Guaranteed 256×256 WebP export with adaptive compression to target < 200KB
  • Dark mode with system preference + toggle
  • Toast notifications (sonner) and accessible UI (shadcn/ui + Tailwind)

Tech Stack

  • React + Vite + TypeScript
  • Tailwind CSS, shadcn/ui components
  • next-themes (dark mode)
  • react-easy-crop (cropping)
  • @huggingface/transformers (background removal)

Getting Started

Reddit PFP Maker

Install GitHub App

A lightweight and accessible tool to generate profile pictures for Reddit and other platforms.


How to Install

  1. Click the button above or install here.
  2. You’ll be taken to GitHub’s App installation page.
  3. Choose which repositories you want the app to access:
    • All repositories (if you want it available everywhere), or
    • Only select repositories (pick the ones you want).
  4. Click Install.
  5. The app will now be active on the chosen repositories and ready to use!

How to Use

  1. Click "Choose File" (or drag & drop) to load an image.
  2. Adjust the crop and use the Zoom slider as needed.
  3. (Optional) Click "Remove Background (AI)". First run downloads the model (~10–20s, cached by the browser where possible).
  4. Click "Make it fit" to auto-center a square crop.
  5. Click "Download 256×256" to export a circular 256×256 WebP. The app adapts quality to stay under 200KB and warns if it can’t.
  6. Use the sun/moon button (top-right) to toggle dark mode.

Privacy & Performance

  • All processing is in-browser. Images never leave your device.
  • Background removal downloads a segmentation model from Hugging Face CDNs at runtime and executes locally (WebGPU preferred, falls back to WebGL/CPU when needed).
  • Large images are resized to max 1024px on the longest side before segmentation for speed and memory efficiency.

Accessibility

  • Buttons and controls have accessible labels
  • Keyboard- and screen reader-friendly components courtesy of Radix/shadcn

Known Limits

  • Extremely detailed or noisy images may exceed 200KB even after compression; the app will notify you.

Contributing

Pull requests are welcome. Keep components small, use the design tokens in src/index.css, and prefer semantic HTML with one H1 per page.

License

MIT

About

reddit-pfp-maker is a lightweight tool to generate profile pictures for Reddit (and other platforms). It’s designed to be: Easy to use — minimal setup, clear defaults. Customizable — templates, text, colors, and export options. Accessible — keyboard-friendly and clear contrast by default.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages