i3
Version, currently 0.4.15 versions
github.com/woodruffw/i3.cr
A Crystal interface to the i3 window manager.
3 stars
0 dependents
License: MIT with restrictions
Installation
# Add this to your shard.yml
dependencies:
i3:
github: woodruffw/i3.cr
version: ~> 0.4.1Then run:
shards installshard.yml
- Crystal
0.24.1- License
- MIT with restrictions
- Author
- William Woodruff
Dependencies
This version declares no dependencies.
README
i3.cr

A Crystal interface to the i3 window manager, using i3's IPC protocol.
Installation
Add this to your application's shard.yml:
dependencies:
i3:
github: woodruffw/i3.cr
Usage
require "i3"
# create a connection object and manage it manually
con = I3::Connection.new
con.subscribe("workspace")
con.command("workspace 1")
con.close
# or, let `act` do it for you:
I3.act do |con|
con.command("workspace 1")
sleep(0.1)
con.command("workspace 2")
end
TODO
- Figure out a way to expose events as callbacks (lack of threads makes this difficult)
Contributing
- Fork it (https://github.com/woodruffw/i3/fork)
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request
Contributors
- woodruffw William Woodruff - creator, maintainer
Documentation
Built from the current release. The first visit to a release nobody has asked for starts its build.
Links
This release
- Version
0.4.1- Tagged
- Jun 4, 2020
- Commit
7047067c10a1- Crystal
0.24.1- Indexed
- yes
Dependents
No indexed shard depends on this one yet.
Repository
github.com/woodruffw/i3.cr
Metadata
- Created
- Aug 12, 2026
- Updated
- Aug 15, 2026
- Synced
- Aug 15, 2026
- Versions
- 5