DropTerm
A native, Yakuake/Guake-style drop-down terminal for the COSMIC desktop (Pop!_OS 24.04+, Wayland, cosmic-comp), written in Rust with libcosmic.
The terminal slides down from the top (or bottom) edge of the screen and is toggled with a global keyboard shortcut. It is a true layer-shell overlay — not a minimize/restore window trick — so it stays above other windows, is hidden from Alt-Tab and the dock, and keeps your shell session alive while hidden.
Start here
- Common tasks - the task-shaped entry point: the exact key or verb for what you want to do
- Configuration - all 52 config keys, profiles, and direct editing
- Keybindings - every default chord and how to rebind
- CLI reference - scripting the running instance: new tabs, the tab verbs,
--is-visible - Panel applet - toggling DropTerm and reading its state from the COSMIC panel
- FAQ - the recurring questions, answered directly
In depth
- Settings drawer - the five sections and when each edit applies
- Status bar - the 28 px glance band: segments, click-to-copy, selection, its menu
- Session persistence - what is saved, when, and how restore behaves
- Theming - the Application theme pin and the 12 built-in color schemes
- Slide animation - the 130 ms slide and its reversal rules
- Bell notifications - hidden-terminal bells and the per-tab latch
- Inline images -
imgcatand OSC 1337: images render in the terminal and scroll away with the output - Release notes - what each tagged release changed, curated and linked
Building and contributing
- Development - the dev loop and running without a shortcut
- Testing - the manual test checklist every change answers to
- Architecture - the module map and the load-bearing seams
Decisions
- Research & decision log - why each non-trivial feature looks the way it does, with the rejected alternatives: peer surveys across terminals, panel-visibility protocol findings, packaging rulings.
Installing from a release or from source, the shortcut setup walk, credits, and the roadmap live in the README and ROADMAP on GitHub.