Skip to content

javipd/swipic

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

swipic demo

swipic

Stop hoarding photos you'll never look at.

PyPI macOS Python 3.10+ MIT License GitHub stars


  • 📸 Tinder-style swiping for your macOS Photos.app library
  • ⌨️ Keyboard-driven keep, reject, U undo
  • 📅 Filter by date — year, month, or specific day
  • 🗑️ Safe deletes — one confirmation for the whole batch, 30-day recovery
  • 🍎 Native macOS — reads Photos.app directly, no export needed

Install

pipx install swipic

Or with uv:

uvx swipic

Usage

swipic              # all photos
swipic 2023         # only 2023
swipic 2023-06      # only June 2023
swipic 2023-06-15   # only that day
⌨️ Keyboard controls
Key Action
Keep photo
Reject photo
U Undo last decision
Q / Esc End session

How it works

  1. swipic reads your Photos.app library directly
  2. Photos appear one by one — press to keep or to reject
  3. When you're done, macOS asks for confirmation once for all rejected photos
  4. Confirmed deletions go to Recently Deleted (recoverable for 30 days)

Setup

swipic needs access to your Photos library. Grant it in:

System Settings → Privacy & Security → Photos → set Terminal (or iTerm2) to Full Access

If Terminal doesn't appear in the list, click + and add it from /Applications/Utilities/Terminal.app.

License

MIT