edu4rdshl/Strata
1
0
Fork 0
mirror of https://github.com/edu4rdshl/Strata.git synced 2026-07-17 23:24:46 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
7 commits 1 branch 11 tags 795 KiB
Find a file
edu4rdshl eb64476a2a perf: eliminate unnecessary clones in write_to_clipboard 
write_to_clipboard took ownership of WriteRequest but immediately
cloned both fields into locals, then cloned bytes again for the text
path -- three heap allocations on a potentially large byte buffer.

Destructure the owned request directly and move the fields. The text
path still needs one clone (bytes goes into two MimeSources), but the
extra upfront clones are gone.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-05-25 03:43:33 -05:00
.github/workflows Initial commit 2026-05-25 03:02:34 -05:00
contrib/systemd Initial commit 2026-05-25 03:02:34 -05:00
strata-daemon perf: eliminate unnecessary clones in write_to_clipboard 2026-05-25 03:43:33 -05:00
strata@edu4rdshl.dev fix: avoid double-destroy in clearItems() 2026-05-25 03:43:09 -05:00
.gitignore Initial commit 2026-05-25 03:02:34 -05:00
AGENTS.md Initial commit 2026-05-25 03:02:34 -05:00
ARCHITECTURE.md Initial commit 2026-05-25 03:02:34 -05:00
CHANGELOG.md Initial commit 2026-05-25 03:02:34 -05:00
Makefile Initial commit 2026-05-25 03:02:34 -05:00
README.md Initial commit 2026-05-25 03:02:34 -05:00

README.md

Strata

A fast, stutter-free clipboard manager for GNOME Shell.

All heavy work (hashing, decoding, storage, search, thumbnails) lives in a Rust daemon. The GNOME Shell extension only renders UI and forwards events over D-Bus, so the compositor is never blocked, even with thousands of items.

Architecture

Strata is two components, and you need both for it to work:

Component Language Role
strata-daemon/ Rust + tokio + zbus Storage (SQLite + FTS5), dedup, thumbnails, D-Bus service org.gnome.Strata
strata@edu4rdshl.dev/ GJS (GNOME Shell extension) Top-bar panel, search UI, paste-back, clipboard ingest

The extension auto-connects to the daemon on enable. If the daemon is managed by systemd (or another init system), the extension detects it and skips spawning its own copy. If no daemon is running, the extension looks for strata-daemon in $PATH and spawns it directly.

GNOME Shell (GJS)  ──D-Bus──▶  strata-daemon  ──▶  SQLite (~/.local/share/strata)
                                       │
                                       └──▶  thumbnails (~/.cache/strata)

Requirements

  • GNOME Shell 50 (tested). May work on 45–49 but untested — if you try it and it works, please open an issue to let us know.
  • strata-daemon binary in $PATH (see Install below)
  • Rust 1.74+ (build only)
  • glib-compile-schemas (from glib2-devel / libglib2.0-dev-bin)
  • SQLite is bundled via rusqlite, no system dep needed

Install

From source (local build)

git clone https://github.com/Edu4rdSHL/Strata.git
cd Strata

# Build and install the daemon binary to ~/.local/bin
make install-daemon

# Install the GNOME Shell extension
make install

Make sure ~/.local/bin is in your $PATH, then log out / log back in (Wayland) or Alt+F2 → r (X11) and enable:

gnome-extensions enable strata@edu4rdshl.dev

Via systemd user service (distro packages / manual)

Distro packages install the daemon binary to /usr/bin/strata-daemon and the systemd unit from contrib/systemd/strata-daemon.service to /usr/lib/systemd/user/. Enable it once:

systemctl --user enable --now strata-daemon

Then install and enable the extension as above. The extension detects the running daemon and will not spawn a second copy.

Pack for extensions.gnome.org

make pack          # produces strata@edu4rdshl.dev.shell-extension.zip (JS only)

Uninstall

gnome-extensions disable strata@edu4rdshl.dev
rm -rf ~/.local/share/gnome-shell/extensions/strata@edu4rdshl.dev
rm -rf ~/.local/share/strata ~/.cache/strata    # also wipes history

Other desktops?

The daemon is desktop-agnostic. It speaks plain D-Bus and runs anywhere the session bus does. Any client (KDE applet, CLI tool, your own script) can drive it. See strata-daemon/README.md for the wire protocol and a busctl example.

The shipped UI is a GNOME Shell extension. Ports to other desktops only need a new front-end against the same D-Bus interface.

Deeper reading

AI Policy Disclosure

Parts of this codebase and documentation were written with the assistance of AI tools. This is the policy we follow and will continue to follow: every line of code and every document produced with AI assistance is rigorously reviewed by a human before being published. No AI-generated output is committed without understanding, verification, and approval by the project author.

License

GPL-3.0-or-later.