2024-06-04 22:20:13 +00:00
|
|
|
# unhacs
|
|
|
|
|
|
|
|
A command line alternative to the "Home Assistant Community Store", aka HACS
|
|
|
|
|
2024-06-10 21:26:42 +00:00
|
|
|
## Installation
|
|
|
|
|
|
|
|
```bash
|
|
|
|
pipx install unhacs
|
|
|
|
```
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
Unhacs provides several commands to manage your Home Assistant packages:
|
|
|
|
|
|
|
|
### Add a package
|
|
|
|
|
|
|
|
To add a package, use the `add` command followed by the URL of the package. Optionally, you can specify the package name and version:
|
|
|
|
|
|
|
|
```bash
|
2024-07-08 17:38:37 +00:00
|
|
|
unhacs add <package_url> --version <version>
|
2024-06-10 21:26:42 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
If the package already exists, you can update it by adding the `--update` flag:
|
|
|
|
|
|
|
|
```bash
|
2024-07-08 17:38:37 +00:00
|
|
|
unhacs add <package_url> --update
|
|
|
|
```
|
|
|
|
|
|
|
|
If the package is a Lovelace plugin, you must specify it using the `--plugin` flag:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
unhacs add --plugin <package_url>
|
|
|
|
```
|
|
|
|
|
|
|
|
If you already have a list of packages in a file, you can add them all at once using the `--file` flag:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
unhacs add --file <file_path>
|
2024-06-10 21:26:42 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
### List packages
|
|
|
|
|
|
|
|
To list all installed packages, use the `list` command:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
unhacs list
|
|
|
|
```
|
|
|
|
|
|
|
|
For a more detailed output, add the `--verbose` flag:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
unhacs list --verbose
|
|
|
|
```
|
|
|
|
|
|
|
|
### Remove a package
|
|
|
|
|
|
|
|
To remove a package, use the `remove` command followed by the name of the package:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
unhacs remove <package_name>
|
|
|
|
```
|
|
|
|
|
|
|
|
### Upgrade packages
|
|
|
|
|
|
|
|
To upgrade all packages, use the `upgrade` command:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
unhacs upgrade
|
|
|
|
```
|
|
|
|
|
|
|
|
To upgrade specific packages, add their names after the `upgrade` command:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
unhacs upgrade <package_name_1> <package_name_2> ...
|
|
|
|
```
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
|
|
Unhacs is licensed under the MIT License. See the LICENSE file for more details.
|
|
|
|
|
2024-06-04 22:20:13 +00:00
|
|
|
## Original repo
|
|
|
|
|
|
|
|
Originally hosted at https://git.iamthefij.com/iamthefij/unhacs.git
|