Thanks to visit codestin.com
Credit goes to Github.com

Skip to content

ramcav/napkin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Napkin 🗒️

A tiny macOS scratchpad for quick, disposable notes. Hit double Right Shift to pop it up, type, and let it auto‑shred after a timer you choose.

Useful for quick notes, ideas, or writing down momentary information without polluting your main notes.

A quick poem 🥀

What it does

  • Shred‑by‑default notes: text lives locally and auto‑deletes after a countdown
  • Double Right Shift to bring the window forward (app must be running)
  • Snooze the timer (by one hour currently)
  • Local notifications: a heads‑up 1 minute before shredding
  • Pretty, customizable gradients and glassy UI

What I want it to do

  • Custom key bindings for opening the app
  • Multiple note management
  • Export to Apple Notes
  • Excalidraw-like drawings
  • Granular shredding times

Privacy

  • 100% local. No network calls.
  • Your text is saved in your user Application Support so you don’t lose it on quit. When shredding, we clear the file (with a best‑effort overwrite if enabled).

Permissions you’ll see (and why)

  • Input Monitoring: needed to listen for the double‑Right‑Shift system‑wide while the app is running.
  • Notifications: to warn you a minute before shredding.

Keyboard

  • Primary: double‑press Right Shift (the one under Return/Enter) to bring the app forward while it’s running.
  • Snooze shortcuts are in the UI.
  • Working on a way to add custom key bindings.

Build & run

  • Requirements: Xcode 15+, macOS 14+
  • Open the Xcode project/workspace and run the napkin app target
  • On first use:
    • Approve Input Monitoring (System Settings → Privacy & Security → Input Monitoring)
    • Approve Notifications if you want the 1‑minute warning
    • If exporting to Notes, macOS will prompt to allow automation of Notes

Settings

  • Shredding: set the default shred interval time (in hours)
  • Appearance: pick gradient colors and style

Troubleshooting

  • Double Right Shift doesn’t work: make sure Input Monitoring is enabled for Napkin. Toggle it off/on and relaunch if needed.
  • Previews don’t open Settings: that action only works in a running app.

Project structure (high‑level)

  • App/: SwiftUI App entry and app‑level views
  • Features/Note/: Note UI + services (timer, persistence)
  • Services/: Hotkeys and persistence helpers
  • UI/: Reusable UI (glass container, gradients, theme)

License

  • Code: MIT (see LICENSE)
  • Font: Knewave by Tyler Finck — SIL Open Font License 1.1 (see LICENSES/Knewave-OFL-1.1.txt)

Thanks for trying Napkin. Keep what matters; shred the rest.

About

A tiny macOS scratchpad for quick, disposable notes.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages