3 stable releases
1.0.3 | Jun 8, 2023 |
---|---|
1.0.2 | Jun 6, 2023 |
#1687 in Command line utilities
13KB
231 lines
I renamed this crate to https://crates.io/crates/appimanager
This site has the same app, but is versioning is different,and may be deleted soon, please use the one above.
AppImanager - Create and manage .desktop entry
for your AppImages or any Executables.
A Cli tool to quickly add your AppImage (or anything checked as executables) to the Applications menu of your desktop environment by generating a .desktop file as an entry.
Simple, yet has many customizable options for the sake of convenience.
Installation
Cargo is required to run this app. After installed cargo, run:
cargo install appimanager
Usage
A simple cli to create and manage desktop entries from executables
Usage: appimanager [OPTIONS] <COMMAND>
Commands:
add Generate .desktop file
list List .desktop files
delete Delete .desktop file by index (displayed by list subcommand)
help Print this message or the help of the given subcommand(s)
Options:
-d, --dest-dir <DEST_DIR> Destination path that store all .desktop files (default=~/.local/share/applications)
-h, --help Print help
-V, --version Print version
Examples:
1. appimanager add myfile.AppImage
-m: move executable to a path before generating .desktop file
-n: name property of to be generated .desktop file
-i: icon (path) property of to be generated .desktop file
2. appimanager list
3. appimanager delete 0 // note: .desktop index starts from 0
4. set custom directory of desktop files instead of ~/.local/share/applications (not recommended)
appimanager -d /path/here/ add myfile.AppImage //create myfile.desktop in /path/here/
appimanager -d /path/here/ list //list .desktop in /path/here
appimanager -d /path/here/ delete 0 //delete index 0 .desktop in /path/here
Build from source
Steps:
git clone https: //github.com/khuongduy354/appimanager.git
cd appimanager
cargo run //to build and run
cargo build //to build only
cargo test //to test
Additional things:
- justfile (Makefile alternatives) to help automate stuffs (you need just to run it)
- personal.md docs my learning stuffs
Contributing
- I really need mentoring on: app features, Rust best practices, implementations, or structures of the app. I'd be very appreciate if anyone could give any sort of guidances.
- Feels free to raise issues and suggest features.
- Don't forget to leave a star!
Notes
- For cargo: i published a crate called appim before, which is also the previous name of this repo, then i realized that not only AppImage is executable :) , this crate changes a bit, more features and has test coverage.
Dependencies
~1.1–1.7MB
~32K SLoC