This commit is contained in:
2026-09-12 11:41:07 +02:00
parent 4617ae4150
commit b76c4ba809
11 changed files with 33 additions and 33 deletions

View File

@@ -1,8 +1,8 @@
# Clipb(h)oard — Implementation Bible
# Cliphoard — Implementation Bible
## 0. Mission
Build **Clipb(h)oard**, a tiny, extremely fast, keyboard-first clipboard history utility.
Build **Cliphoard**, a tiny, extremely fast, keyboard-first clipboard history utility.
Primary target:
@@ -17,7 +17,7 @@ Future-friendly:
But **do not compromise v1 simplicity to prematurely support every platform**.
Clipb(h)oard is intentionally small.
Cliphoard is intentionally small.
The core workflow is:
@@ -477,7 +477,7 @@ At minimum:
```text
Global shortcut
Open/toggle Clipb(h)oard
Open/toggle Cliphoard
Escape
Close popup
@@ -551,7 +551,7 @@ This means the user can still manually press `Ctrl+V`.
# 17. Clipboard Self-Change Suppression
Clipb(h)oard itself changes the clipboard when users restore entries.
Cliphoard itself changes the clipboard when users restore entries.
These changes must not produce broken behavior such as:
@@ -726,7 +726,7 @@ The config file remains understandable and editable manually.
# 24. Autostart
Clipb(h)oard should autostart with the user's graphical session.
Cliphoard should autostart with the user's graphical session.
For Linux Mint/X11, use normal desktop autostart mechanisms.
@@ -740,9 +740,9 @@ Autostart behavior should be configurable.
# 25. Single Instance
Only one Clipb(h)oard process may own clipboard monitoring at a time.
Only one Cliphoard process may own clipboard monitoring at a time.
Starting Clipb(h)oard while it is already running should:
Starting Cliphoard while it is already running should:
- communicate with the existing instance if practical
- open/toggle the popup
@@ -847,7 +847,7 @@ Never claim security guarantees the platform cannot provide.
If a tray icon is used, keep its menu minimal:
```text
Open Clipb(h)oard
Open Cliphoard
Pause Recording
Clear History
Settings
@@ -862,7 +862,7 @@ If tray integration creates disproportionate platform complexity, v1 may omit it
# 30. Error Handling
Clipb(h)oard must not panic for ordinary runtime failures.
Cliphoard must not panic for ordinary runtime failures.
Use idiomatic Rust error handling.
@@ -884,7 +884,7 @@ X11 reported that the key combination is already grabbed by another application.
The user should understand:
- what failed
- whether Clipb(h)oard can continue
- whether Cliphoard can continue
- what they can do about it
Fatal errors should terminate cleanly with a useful message and log.
@@ -1081,7 +1081,7 @@ clipbhoard
Display name:
```text
Clipb(h)oard
Cliphoard
```
---
@@ -1680,7 +1680,7 @@ Cost
# 57. Definition of Success
Clipb(h)oard succeeds if the user forgets it exists until they need something they copied earlier.
Cliphoard succeeds if the user forgets it exists until they need something they copied earlier.
Then:
@@ -1694,6 +1694,6 @@ and it works.
Every time.
The best version of Clipb(h)oard is not the version with the most features.
The best version of Cliphoard is not the version with the most features.
It is the version where the core interaction is so fast and dependable that there is nothing left to think about.

View File

@@ -1,4 +1,4 @@
# Clipb(h)oard hardening and completion checklist
# Cliphoard hardening and completion checklist
This is the persistent implementation checklist for the long-horizon audit goal.
Items are checked only after the live code has been built/tested and the relevant

View File

@@ -1,4 +1,4 @@
# Clipb(h)oard shipping checklist
# Cliphoard shipping checklist
This checklist tracks the MVP completion criteria from `BIBLE.md`. Items are
checked only after implementation and an evidence-producing verification.

View File

@@ -1,6 +1,6 @@
# Clipb(h)oard
# Cliphoard
Clipb(h)oard is a small, local-only, keyboard-first clipboard history utility for Linux/X11.
Cliphoard is a small, local-only, keyboard-first clipboard history utility for Linux/X11.
The core is implemented in Rust with SQLite persistence and TOML configuration. The default build intentionally keeps the GTK/X11 desktop integration behind the `gui` feature so the data model and persistence tests can run on machines without GTK development libraries.
@@ -31,7 +31,7 @@ The resulting package declares its runtime libraries, so Debian/Ubuntu users
can install it with `sudo apt install ./target/clipbhoard_0.1.0_amd64.deb` and
the package manager will resolve GTK/X11 runtime dependencies automatically.
Once installed, Clipb(h)oard runs as a background process. `Super+V` opens the
Once installed, Cliphoard runs as a background process. `Super+V` opens the
popup, and `clipbhoard --show` requests it without keeping the invoking shell
blocked. On Cinnamon, a StatusNotifier tray icon provides another way to open
the popup when the desktop panel exposes tray icons.

View File

@@ -1,6 +1,6 @@
[Desktop Entry]
Type=Application
Name=Clipb(h)oard
Name=Cliphoard
Exec=clipbhoard --autostart
OnlyShowIn=Cinnamon;GNOME;KDE;XFCE;
X-GNOME-Autostart-enabled=true

View File

@@ -1,6 +1,6 @@
[Desktop Entry]
Type=Application
Name=Clipb(h)oard
Name=Cliphoard
Comment=Fast, keyboard-first clipboard history
Exec=clipbhoard
Icon=io.clipbhoard.Clipbhoard

View File

@@ -3,9 +3,9 @@ Version: 0.1.0
Section: utils
Priority: optional
Architecture: amd64
Maintainer: Clipb(h)oard contributors
Maintainer: Cliphoard contributors
Depends: libgtk-4-1, libdbus-1-3, libx11-6, libxfixes3, libxtst6
Description: fast, keyboard-first clipboard history
Clipb(h)oard keeps a small local history of textual clipboard entries.
Cliphoard keeps a small local history of textual clipboard entries.
It provides a compact GTK popup, fuzzy search, pinning, and X11 clipboard
integration without network access or telemetry.

View File

@@ -169,12 +169,12 @@ fn build_window(
root.append(&status);
let window = ApplicationWindow::builder()
.application(application)
.title("Clipb(h)oard")
.title("Cliphoard")
.default_width(720)
.default_height(420)
.child(&root)
.build();
window.set_title(Some(&format!("Clipb(h)oard — {}", config.global_shortcut)));
window.set_title(Some(&format!("Cliphoard — {}", config.global_shortcut)));
pause_button.set_tooltip_text(Some("Pause/resume recording: Ctrl+Alt+R"));
let window_for_close = window.clone();
window.connect_close_request(move |_| {

View File

@@ -37,7 +37,7 @@ impl InstanceGuard {
.context("failed to restrict instance lock permissions")?;
file.try_lock_exclusive().with_context(|| {
format!(
"another Clipb(h)oard instance is already running (lock: {})",
"another Cliphoard instance is already running (lock: {})",
path.display()
)
})?;
@@ -101,10 +101,10 @@ impl InstanceGuard {
pub fn signal_show() -> Result<()> {
let mut stream = UnixStream::connect(socket_path())
.context("could not contact the running Clipb(h)oard instance")?;
.context("could not contact the running Cliphoard instance")?;
stream
.write_all(b"show")
.context("failed to request the running Clipb(h)oard instance to show")?;
.context("failed to request the running Cliphoard instance to show")?;
Ok(())
}
}

View File

@@ -22,7 +22,7 @@ fn main() -> Result<()> {
return Ok(());
}
if args.iter().any(|arg| arg == "--help") {
println!("Clipb(h)oard — tiny, keyboard-first clipboard history");
println!("Cliphoard — tiny, keyboard-first clipboard history");
println!("Usage: clipbhoard [--version] [--help] [--diagnostics] [--show] [--autostart]");
return Ok(());
}
@@ -45,7 +45,7 @@ fn main() -> Result<()> {
.stdout(std::process::Stdio::null())
.stderr(std::process::Stdio::null())
.spawn()
.context("failed to start the background Clipb(h)oard process")?;
.context("failed to start the background Cliphoard process")?;
return Ok(());
}
let instance = match lifecycle::InstanceGuard::acquire() {
@@ -86,7 +86,7 @@ fn main() -> Result<()> {
#[cfg(not(feature = "gui"))]
{
tracing::warn!("GTK/X11 support is not compiled; install GTK4 development packages and rebuild with --features gui");
println!("Clipb(h)oard core is installed, but the GTK/X11 backend is not compiled.");
println!("Cliphoard core is installed, but the GTK/X11 backend is not compiled.");
println!("Rebuild with: cargo run --features gui");
Ok(())
}

View File

@@ -10,7 +10,7 @@ impl ksni::Tray for ClipbhoardTray {
}
fn title(&self) -> String {
"Clipb(h)oard".into()
"Cliphoard".into()
}
fn icon_name(&self) -> String {
@@ -26,7 +26,7 @@ impl ksni::Tray for ClipbhoardTray {
fn menu(&self) -> Vec<ksni::MenuItem<Self>> {
use ksni::menu::StandardItem;
vec![StandardItem {
label: "Show Clipb(h)oard".into(),
label: "Show Cliphoard".into(),
icon_name: "io.clipbhoard.Clipbhoard".into(),
activate: Box::new(|_| {
if let Err(error) = InstanceGuard::signal_show() {