https://github.com/umikoio/sukusho
The native screenshot history manager for MacOS
https://github.com/umikoio/sukusho
hacktoberfest image macos macos-app macos-swift macosx screenshot screenshot-utility swift
Last synced: 3 months ago
JSON representation
The native screenshot history manager for MacOS
- Host: GitHub
- URL: https://github.com/umikoio/sukusho
- Owner: umikoio
- License: gpl-3.0
- Created: 2025-10-13T11:50:45.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-10-17T00:47:52.000Z (9 months ago)
- Last Synced: 2025-11-05T22:15:11.530Z (8 months ago)
- Topics: hacktoberfest, image, macos, macos-app, macos-swift, macosx, screenshot, screenshot-utility, swift
- Language: Swift
- Homepage:
- Size: 1.66 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Sukusho
The native screenshot history manager for MacOS
Sukusho is a utility that saves your screenshot history in memory, so if you need to take multiple screenshots, but don't want to save them immediately to your local drive, this is for you. After you successfully take a screenshot, a row will populate in Sukusho's top menu bar. These screenshots will remain until you clear the history, exceed the max number of screenshots (10), or quit the program.
## Installation
Install with a single command:
```bash
curl https://umiko.io/sukusho.sh | sh
```
Once the installation script has completed, you should see `Sukusho v0.x.x successfully installed`. From there, just head over to the `/Applications` directory and run Sukusho!
Here's a screenshot taken by Sukusho:
### Keyboard Shortcuts
If you don't want to manually click any buttons or open the modal, a few keyboard shortcuts are available:
| Shortcut | Action |
| -------- | -------------------- |
| `⌘ + N` | Take a screenshot |
| `⌘ + Q` | Quit the application |
NOTE: Sukusho must be the active foreground application. You can just click the Sukusho dock icon to make it the active application.
> [!IMPORTANT]
> The install script above adds Sukusho to your quarantine settings.
> While Sukusho is safe to use, works fully offline, and has no analytics whatsoever built-in, I've decided to not sign the app. This may change, but for now, it's installable via the script above.
NOTE: Sukusho is not currently compatible with the default MacOS screenshot utility. There are also no keyboard shortcuts yet. You must use Sukusho directly to take and save screenshots. I have these on the backlog.
#### Windows / Linux Support?
I built this for MacOS only using native interfaces (i.e Swift, AppKit, etc.), however, if I ever personally need something like this on Linux or Windows, I'll build it. If this project gains traction and people need a solution for Linux or Windows, I'll build it. If you seriously need something like this, create an issue for your operating system, and I'll begin looking into it.