pho

Phở

Features

• Manage AppImages by organizing them in a single folder.
• Integrates AppImages seamlessly. (AppImages must follow AppImage Specification to be integrated with desktop.)
• Ability to download AppImages from Github Releases and URLs.
• Supports updation of AppImages. (AppImages fetched from Github Releases only.)
• Configuration files can be manually edit to further customize functionality.

Installation

Using Script

Run the below command in terminal. This installs Pho at ~/.local/bin.

curl -Ls https://raw.githubusercontent.com/zyrouge/pho/main/install.sh | bash

If you need to install into a custom path, use the below command.

# ensure that the directory exists
mkdir -p /custom/directory

curl -Ls https://raw.githubusercontent.com/zyrouge/pho/main/install.sh | bash -s /custom/directory

Manual

1. All releases can be found here. Choose a valid release.
2. Binaries are built for 32-bit/64-bit AMD and ARM separately. Download the appropriate one.
3. Rename the downloaded binary to pho and place it in a folder that is available in the PATH environmental variable. Typically this would be ~/.local/bin.
4. Run pho init to setup necessary configuration.
5. Have fun! 🎉

Examples

• pho init - Initialize Pho configuration.
• pho install local ./SomeApp.AppImage - Install and integrate a local AppImage.
• pho install github owner/repo - Download, install and integrate an AppImage from Github Releases.
• pho update - Update all installed AppImages.
• pho uninstall some-app - Uninstall an AppImage.

Developement

1. Have Install Go and Git installed.
2. Fork and/or Clone this repository.
3. Install dependencies using go get.
4. Run the application using go run main.go.
5. Build the application using ./scripts/build.sh.

Contributing

Any kind of contribution including creating issues or making pull requests is welcomed. Make sure to keep it pointful. Donations through GitHub Sponsors or Patreon are welcomed. It helps me to stay motivated.

License

MIT