Ian Fijolek
3365c474a8
2.4 KiB
unhacs
A command line alternative to the "Home Assistant Community Store", aka HACS
Installation
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:
unhacs add <package_url> --version <version>
If the package already exists, you can update it by adding the --update flag:
unhacs add <package_url> --update
If the package is a Lovelace plugin, you must specify it using the --plugin flag:
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:
unhacs add --file <file_path>
Add a component from a forked Home Assistant Core repository
To add a component from a fork of home-assistant/core, use the --forked-component flag followed by the URL of the forked repository and then specify the branch with the --branch flag:
unhacs add --forked-component <forked_repo_url> --branch <branch>
List packages
To list all installed packages, use the list command:
unhacs list
For a more detailed output, add the --verbose flag:
unhacs list --verbose
List tags
To list all tags for a package, use the tags command followed by the name of the package:
unhacs tags <package_url>
The number or returned tags is limited to 10 by default. To change this, add the --limit flag:
unhacs tags <package_url> --limit 20
Remove a package
To remove a package, use the remove command followed by the name of the package:
unhacs remove <package_name>
Upgrade packages
To upgrade all packages, use the upgrade command:
unhacs upgrade
To upgrade specific packages, add their names after the upgrade command:
unhacs upgrade <package_name_1> <package_name_2> ...
Use git tags
By default, identification of releases uses the GitHub API. If you want to use git tags instead, you can add the --git-tags flag to the base command:
unhacs --git-tags add <package_url>
License
Unhacs is licensed under the MIT License. See the LICENSE file for more details.
Original repo
Originally hosted at https://git.iamthefij.com/iamthefij/unhacs.git