🧊 IceShot 🥃
	An opinionated screenshot app for macOS.

---

Installation

Download the latest prebuilt binary from the releases page.

Alternatively, build it from source.

Build from Source

Prerequisites

To compile from source, make sure your environment meets the following requirements:

• Odin (programming language)
• clang (c and objective-c compiler)
• make (build tool)

Steps

1. Clone the repository:

   git clone https://github.com/mikuwithbeer/IceShot.git
   cd IceShot

2. Run the bundler script:

   ./bundle.sh release

The compiled application will be available as IceShot.app in the repository root.

Screenshots

Reason

There are already lots of screenshot applications, and many of them are great. I built IceShot because none of them matched the way I take screenshots.

I used Shottr¹ for a long time and really liked it. I completely understand that software needs to make money, but I found the purchase popup a bit distracting. After seeing it enough times, I decided to build something that fit my own workflow.

Then I realised that almost every screenshot I took looked the same:

• Capture part of the screen.
• Crop it.
• Cover something with a rectangle.
• Save or copy the image.

I rarely used text, arrows, stickers, counters, or any of the other annotation tools.

IceShot is built around that simple workflow. If yours is similar, you'll probably enjoy using it.

Configuration

IceShot runs as two small processes:

Daemon

The daemon sits in your menu bar and listens for your shortcut. When you trigger, it starts the worker.

Its configuration is stored inside ~/.iceshot/daemon.json.

Worker

The worker is the screenshot application itself.

The first time you launch it, it creates a default configuration file inside ~/.iceshot/worker.json. Even if there is few, settings can be changed by editing this file.

Saving Image

IceShot can save screenshots as:

• PNG
• JPG / JPEG
• BMP

Screenshots are saved to the output directory configured inside worker.json.

Shortcuts

Daemon

The daemon listens globally, so these shortcuts work from anywhere.

Shortcut	Action
Command + Shift + 3	Capture Screen

Worker

General

Shortcut	Action
Command + Z	Undo
Command + Shift + Z	Redo
Command + Shift + S	Share Image
Command + C	Copy Image
Command + S	Save Image

Tools

Press the key again to enable or disable a tool.

Shortcut	Tool
C	Crop
R	Rectangle
L	Line
T	Triangle
I	Color Picker
M	Measurement
O	Rotate 90° Clockwise
V	Use Vision (OCR)

Navigation

Shortcut	Action
Mouse Wheel	Zoom
WASD / Arrow Keys	Pan
Space + Mouse Drag	Pan

Appendix

This project is licensed under the BSD-2-Clause Plus Patent License².

Footnotes

1. https://shottr.cc ↩

2. https://spdx.org/licenses/BSD-2-Clause-Patent.html ↩