6 releases (stable)
new 1.2.1 | Mar 25, 2025 |
---|---|
1.2.0 | Mar 24, 2025 |
1.0.0 | Apr 13, 2023 |
0.2.0 | Apr 13, 2023 |
0.1.1 | Apr 11, 2023 |
#269 in Text processing
175 downloads per month
26KB
537 lines
zp
zp
is a command-line tool designed to copy text or data from files or standard output buffers directly to the clipboard. This can be particularly useful for developers and power users who need quick access to snippets of code, configurations, or any other textual information.
Usage
Copying from a File
To copy the entire contents of a file:
zp my_file.txt
To get the first n
words from a file:
zp -s n my_file.txt
To get lines between a range, i.e., lines n
to m
:
zp -s n -e m my_file.txt
Copying from Standard Output
To copy the entire output of a command:
cat sample_file.txt | zp
For ranges and specific words, you can use similar flags as with files.
Logs and History
Every copied content is saved to a history file located in your home directory (~/.zp/clipboard_history.json
). You can view the copy history using:
zp --logs
This provides an interactive interface showing the last copied items, along with timestamps. The log viewer supports navigation, copying, and exiting.
Daemon Mode
The zp
tool also includes a clipboard monitoring daemon to automatically save any changes made to the clipboard. This can be especially useful if you want to keep a history of every change made to your clipboard without manually triggering the copy command each time.
Starting the Daemon
To start the clipboard monitoring daemon:
zp --daemon
This will fork the tool into the background and continue running, automatically saving any clipboard changes.
Stopping the Daemon
To stop the clipboard monitoring daemon:
zp --stop-daemon
Checking the Daemon Status
You can check if the daemon is currently running with:
zp --daemon-status
This will inform you whether the daemon is active and provide its process ID.
Installation
The recommended way to install zp
is using Rust's package manager, Cargo. Here are several methods:
Using Cargo Install (Recommended)
cargo install zp
From Source
For those who prefer building from source, you can clone the repository and build it manually:
git clone https://github.com/bahdotsh/zp.git
cd zp
cargo install --path .
This method allows you to customize or modify the code before installation.
License
zp
is licensed under the MIT license. See the LICENSE
file for more details.
Dependencies
~9–22MB
~328K SLoC