Adithya V. Sastry

Robotics + Origami
Creator of Tin Can Linux
Lover of all things tiny


"A dream is not that which you see while
sleeping, it is that which does not let
you sleep."

-- Dr. APJ Abdul Kalam

|-----------------------|
| TURTLE                |           ()---()
|-----------------------|       ,--/ ()()()\
| A tiny window manager |       |: |()()()()|>
| written in Rust.      |       `--\ ()()()/
|-----------------------|           ()---()
=~=~=~=~=~=~=~=~=~=~=~=~=

This is the webpage for turtle. For general information about building and
installing, see the github repo.

=== CONFIGURATION
=================

Turtle will look for a configuration file at ~/.config/turtle/config.ron. An
example config file is provided in the repo. Turtle also supports running a
startup script at ~/.config/turtle/autostart.

=== INFO FILE
=============

Turtle provides an info file at ~/.config/turtle/info.txt. Currently this
outputs a single line with the format 'focused:[id]' which gives the id of
the currently focused window. This may be useful for use in shell scripts or
statusbars.

=== KEYBINDS
============

The default keybinds for turtle are listed below:
  - Super + Shift + Q: quit turtle
  - Super + W: kill focused window
  - Super + F: make a window fullscreen (ignores all gaps)
  - Super + T: make a window large (respects gaps)
  - Super + S: make a window small
  - Super + [: cycle windows left
  - Super + ]: cycle windows right
  - Super + Tab: switch to the last focused window
  - Super + Enter: open a terminal (st)
  - Super + Space: open rofi in run mode

Additionally, the following mousebinds are set:
  - Super + LMB: move the selected window
  - Super + RMB: resize the selected window

All keybinds and mousebinds can be set in the config file.
============== Updates ==============
News - 01/19/2025 Tin Can: 27 followers + 17 stars on GitHub News - 12/01/2024 Arc: first release candidate Post - 11/19/2024 LibTorch in Rust using FFIs News - 11/07/2024 Arc: rusty package manager for Linux Post - 06/23/2024 Shared Memory IPC in Rust