Archived
2
25
Fork
You've already forked shko
4
hevel for the laptop
This repository has been archived on 2026年04月13日. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.
  • Zig 96.6%
  • Shell 3.4%
Find a file
2026年04月02日 15:48:40 +02:00
.gitignore default terminal is st-wl 2026年03月08日 15:03:57 -05:00
build.sh update config.zig, move default programs to shko.zig 2026年03月22日 18:56:07 -05:00
build.zig move build to newer api 2026年03月16日 21:21:46 -03:00
config.zig update config.zig, move default programs to shko.zig 2026年03月22日 18:56:07 -05:00
LICENSE init 2026年02月21日 13:57:19 -06:00
README.md Update README.md 2026年04月02日 15:48:40 +02:00
shko.png new logo fix compression 2026年02月22日 16:38:05 +00:00
shko.zig update config.zig, move default programs to shko.zig 2026年03月22日 18:56:07 -05:00
util.zig util.zig calls program messages by basename 2026年03月01日 10:45:07 -06:00

ATTENTION!
shko is no longer maintained.
read through the entire README to see more information

shko

shko sharko -
a little keyboard-oriented floating, zooming, and scrolling neuswc window manager written in zig 0.15.2, originally written by ~shrub900 and now maintained by me.

you could just call it hevel for the laptop.

shko has repositories on:
codeberg
srht (readonly mirror)

build

to compile shko:

zig build

or, alternatively using the shell build system:

./build.sh make

make sure you have already compiled and installed neulibs (neuswc, neuwld)

configuration

configuration variables are stored in the config.zig file,
and are imported by shko.zig to get options from.

config.zig consists of:

  • keybinds
  • border colors
  • border width
  • default programs
  • window behavior

keybindings

general:

  • term: mod+return
  • menu: mod+r
  • exit: mod+shift+q

moving windows:

  • drag: mod+btn_left
  • resize: mod+btn_right

navigating planes:

  • center: mod+period
  • next: mod+tab
  • navi: mod+arrowkeys (up, down, left, right)

zooming:

  • in: mod+= (equals)
  • out: mod+- (minus)
  • fullscreen: mod+f

credits

hevel and its developers, for inspiring the newest features of shko, and indirectly creating neuswc.
thanks ~shrub900 for creating the base of shko.
thanks ~pascalecu (in the form of a divine intervention) for helping me work on the floating mode!!!
thanks in advance, ~uint for creating wsxwm, which is the base of tohu, in which i heavily referenced code from. <3

license

shko is licensed with the unlicense license, effectively putting it in the public domain.
you are free to do whatever you please with this code.

unmaintained

i've decided to step back with my work on shko.
i grew to dislike zig - i hate looking at it, the hype has died, and with these feelings, i dont want to work on shko.
its a pathetic C wrapper, 90% or even greater of the code consists of c interop -
it makes more sense to rewrite it in C at this point. secondly, programs crash, and the runtime leaves no traceback.
or even, it crashes for no reason at all.

i dont want to be associated with this buggy window manager anymore.

i apologize in advance for my incompetency, especially to those interested and contributors to my work.
for a 7 day period, i will search for a potential maintainer to take over this project. if it fails, shko's repository will be archived,
and in advance will recieve no more updates.
open a issue if you would like to maintain shko