gurk 2.0.3

Contains anything related to setting up a new computer (desktop) system

🖥️ gurk 🥒 - The user-friendly package manager allowing customizable and repeatable computer setup

Installation

Ubuntu (22.04+)

Ensure you have pipx installed via python3.12 (or higher) and git:

sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.12 git
python3.12 -m pip install --user pipx
python3.12 -m pipx ensurepath

Then, install gurk via:

pipx install gurk

MacOS, Windows and other Linux distributions

Not supported yet.

Usage

Using gurk you can run various plugins and tasks via

gurk run <plugin>[:<option> | /<task-subname>] [<task-args>]

where <plugin> is a plugin's git URL, the name of an installed plugin or a local path to a custom plugin. For example:

gurk run 'https://github.com/ArturoRoberti/gurk_example_plugin.git'

[!WARNING] Make sure to wrap git URLs in quotes to avoid shell interpretation issues with special characters (e.g. &)

Please have a brief look at the documentation for more information.

Contributing

Please see CONTRIBUTING.md for contribution guidelines.

License

This project is licensed under the Apache 2.0 License - see the LICENSE file for details.

TODO

Please see TODO.md for a list of planned improvements and features.