cross-platform tiny screenshot tool
  • C 91.2%
  • CMake 4%
  • C++ 3.9%
  • Objective-C 0.6%
  • Shell 0.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Paper 2d2620f044
Some checks failed
Ubuntu / test (push) Has been cancelled
*: add .editorconfig (try to nudge forgejo into formatting it right)
2026-11-04 15:34:26 -05:00
.github/workflows CI: comment unused shit 2026-10-07 22:33:34 -04:00
lib *: MacOS port 2026-10-24 02:48:23 -04:00
protocol wayland support (#1) 2026-10-07 21:11:23 -04:00
scripts src/main: add '-c' flag to copy to clipboard 2026-10-14 02:52:33 -04:00
src *: MacOS port 2026-10-24 02:48:23 -04:00
.clang-format *: wlr support 2026-10-08 20:51:00 -04:00
.cmake-format.yaml lib: add tests 2026-10-07 22:21:30 -04:00
.editorconfig *: add .editorconfig (try to nudge forgejo into formatting it right) 2026-11-04 15:34:26 -05:00
.gitattributes git: tell git to normalize CRLF line endings to LF 2026-10-21 15:35:49 -04:00
.gitignore *: MacOS port 2026-10-24 02:48:23 -04:00
CMakeLists.txt *: MacOS port 2026-10-24 02:48:23 -04:00
COPYING *: fix licenses -- lib/ is LGPLv2.1 while src/ is GPLv2.0 2026-09-02 19:51:14 -04:00
README README: update to reflect the current state of affairs 2026-11-03 18:26:10 -05:00

/. intro ./

yukino is a tiny screenshot tool for Linux.

The bulk of the program is in lib/, which contains platform code
for getting screenshots among other funsies such as tiny png and
ppm writers.

It currently can be built for the following platforms, with varying
levels of stability and correctness:

* Wayland. Works fairly well, but which features are supported
  depends on the compositor. Use KWin for the best feature set.

* X11 (via xcb). This is the platform yukino was originally created
  for, and generally it works well. Things may vary depending on
  the exact window manager you're using.

* Windows. Works fairly well, even in a mixed-DPI setup, due to how
  high DPI works from the API level.

* MacOS. Likely does not work on Retina screens, as I do not have a Mac
  to test with at the moment.

* Haiku. Only tested in a VM, will likely break if and when they add
  multi-monitor support.

It can be built on its own as a library, but there are no guarantees
for API nor ABI stability currently.

/. deps ./

For X11, you will only need xcb. Wayland requires some junk to
generate C headers from protocol definitions. Windows and Mac shouldn't
require anything special.

The program requires SDL 3 for it's GUI, meaning it's limited to whatever
platforms SDL supports. In the future I may consider separating out that
code into another library, but that is not planned currently.

/. q&a ./

Q: Why?
A: Because every other screenshot tool for Linux sucks.

Q: What does the name "yukino" mean?
A: Watch OreGairu. Besides that, nothing really, it's just a cute name
   that happens to be pretty short and sweet.

/. contact ./

www: https://tflc.us/
email: paper@tflc.us

/. eof ./