Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/zyrouge/pho

The AppImage Manager that Linux always deserved.
https://github.com/zyrouge/pho

appimage linux package-manager

Last synced: 3 months ago
JSON representation

The AppImage Manager that Linux always deserved.

Host: GitHub
URL: https://github.com/zyrouge/pho
Owner: zyrouge
License: mit
Created: 2023-09-29T07:46:13.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2024-07-14T12:57:00.000Z (6 months ago)
Last Synced: 2024-07-15T10:01:15.298Z (6 months ago)
Topics: appimage, linux, package-manager
Language: Go
Homepage:
Size: 917 KB
Stars: 36
Watchers: 5
Forks: 1
Open Issues: 3
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # Phở

[![Latest Version](https://img.shields.io/github/v/release/zyrouge/pho?label=latest)](https://github.com/zyrouge/pho/releases/latest)

[![Build](https://github.com/zyrouge/pho/actions/workflows/build.yml/badge.svg)](https://github.com/zyrouge/pho/actions/workflows/build.yml)

[![Release](https://github.com/zyrouge/pho/actions/workflows/release.yml/badge.svg)](https://github.com/zyrouge/pho/actions/workflows/release.yml)



    



## 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`.

```bash

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.

```bash

# 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](https://github.com/zyrouge/pho/releases). 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! 🎉

| Binary name | Platform   |

| ----------- | ---------- |

| `pho-386`   | 32-bit AMD |

| `pho-amd64` | 64-bit AMD |

| `pho-arm`   | 32-bit ARM |

| `pho-arm64` | 32-bit ARM |

## 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

0. Have Install [Go](https://go.dev/) and [Git](https://git-scm.com) installed.

1. Fork and/or Clone this repository.

2. Install dependencies using `go get`.

3. Run the application using `go run main.go`.

4. 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](https://github.com/sponsors/zyrouge) or [Patreon](https://patreon.com/zyrouge) are welcomed. It helps me to stay motivated.

## License

[MIT](./LICENSE)