appim 1.0.0

A simple cli tool to create desktop entry from AppImage
appim-1.0.0 is not a library.
Visit the last successful build: appim-1.0.3

AppIm - Create .desktop entry for your AppImage

rust git cli

A Cli tool to quickly add your AppImage to the Applications menu of your desktop environment

By generating a .desktop file as a Applications menu entry.

Simple, yet has many customizable options for the sake of convenience.

Installation

Cargo is required to run this app. After you installed cargo, run:

cargo install appim

Usage

appim add --help
Usage: appim add [OPTIONS] <APPIMAGE_PATH>

Arguments:
  <APPIMAGE_PATH>  Path of appimage file

Options:
  -d, --dest-dir <DEST_DIR>  Destination of desktop file [default: /usr/share/applications]
  -m, --move-dir <MOVE_DIR>  Move appimage file to some location before creating desktop file
  -h, --help                 Print help   

Examples: 
//create myfile.desktop in /usr/share/applications by default
appim add myfile.AppImage     
 
//Usually, after downloaded, the AppImage is in downloads folder,
//hence you may want to use the -m flag to move the AppImage to your personal apps folder, before create .desktop entry 
appim add myfile.AppImage -m "~/apps"  
//myfile.AppImage is now in ~/apps, myfile.desktop also got created in /usr/share/applications with correct exec_path

// create myfile.desktop in ~/local/share 
appim add myfile.AppImage -d "~/local/share"  

Build from source

Steps:

git clone https: //github.com/khuongduy354/appim.git 
cd appim  
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!