Clone or download
Latest commit 3a3e1a5 Oct 6, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin fix for os-release Oct 6, 2018
share Update owo.1 Aug 3, 2018
.gitignore rewrite Jun 26, 2018
LICENSE rewrite Jun 26, 2018
Makefile change default make prefix to /usr/local Jul 8, 2018 spice up readme a little Jul 8, 2018

A shell script for uploading and shortening links to


Dependency OS Notes
curl ALL N/A
maim Linux, BSD For FreeBSD users: version on FreshPorts is ancient
jq ALL Not required if python or ruby present
python ALL Not required if jq or ruby are present
ruby ALL Not required if jq or python are present
ffmpeg ALL Only required for screen recording
xclip Linux, BSD Only required if copy to clipboard is enabled
libnotify/notify-send Linux, BSD Only required if notifications are enabled
terminal-notifier macOS Only required if notifications are enabled

Additional notes

On *BSDs you'll need GNU/make (gmake) to install this script.


From source (recommended)

  1. git clone
  2. cd
  3. git checkout REV where REV is a release. Current latest is v1.0.0
  4. sudo make install, you can change prefix by doing sudo make install PREFIX=/usr


See owo --help

Using the Mac Workflow



Screen recording on macOS?

Symbol Lookup Error on Ubuntu 17.xx
Build from source or upgrade. maim/issues/120.

Wayland support?
No. To elaborate, Wayland quite literally does not support screenshots. It is simply too "secure" to allow such things. Please use Xorg instead.


  1. git clone
  2. Make changes
  3. git add -A && git commit -m 'short message describing your changes'
  4. Create a MR on our repo


The contents of this repository are licensed under the GPL version 3. A copy of the GPL can be found in LICENSE or on FSF's web page.

Also see owo --version