chore: add README
This commit is contained in:
parent
d18ab1cdae
commit
c939a98599
1
.gitignore
vendored
1
.gitignore
vendored
@ -1 +1,2 @@
|
|||||||
/target
|
/target
|
||||||
|
/result
|
||||||
|
52
README.md
Normal file
52
README.md
Normal file
@ -0,0 +1,52 @@
|
|||||||
|
# pumo-system-info
|
||||||
|
|
||||||
|
A Rust-based utility for gathering and presenting system information
|
||||||
|
in JSON format. For now, it only retrieves Bluetooth-related
|
||||||
|
information.
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
`pumo-system-info` is designed to retrieve detailed information about
|
||||||
|
connected Bluetooth devices and present it in a structured JSON
|
||||||
|
format. This utility can be integrated with other tools or scripts for
|
||||||
|
system monitoring and management. In particular, this tool is meant to
|
||||||
|
be used with my [eww](https://elkowar.github.io/eww/) configuration.
|
||||||
|
|
||||||
|
## Prerequisites
|
||||||
|
- DBus
|
||||||
|
- BlueZ (for retrieving Bluetooth-related information)
|
||||||
|
- Rust (specified in `rustup-toolchain.toml`)
|
||||||
|
- Nix package manager with flakes (optional, for building and managing
|
||||||
|
dependencies)
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
1. Clone the repository
|
||||||
|
|
||||||
|
```sh
|
||||||
|
git clone https://labs.phundrak.com/phundrak/pumo-system-info.git
|
||||||
|
cd pumo-system-info
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Build the project
|
||||||
|
1. With Nix
|
||||||
|
```sh
|
||||||
|
nix build
|
||||||
|
./result/bin/pumo-system-info
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Without Nix
|
||||||
|
```sh
|
||||||
|
cargo build --release
|
||||||
|
./target/release/pumo-system-info
|
||||||
|
```
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
|
||||||
|
Contributions are welcome! Please fork the repository and submit a
|
||||||
|
pull request with your changes. Ensure that your commits follow the
|
||||||
|
recommendations of [Conventional
|
||||||
|
Commits](https://www.conventionalcommits.org/).
|
||||||
|
|
||||||
|
## License
|
||||||
|
This project is licensed under the GPL-3 license. See the
|
||||||
|
[LICENSE](LICENSE) file for more details.
|
Loading…
x
Reference in New Issue
Block a user