rename
This commit is contained in:
@@ -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.
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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.
|
||||
|
||||
@@ -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.
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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.
|
||||
|
||||
@@ -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 |_| {
|
||||
|
||||
@@ -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(())
|
||||
}
|
||||
}
|
||||
|
||||
@@ -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(())
|
||||
}
|
||||
|
||||
@@ -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() {
|
||||
|
||||
Reference in New Issue
Block a user