path: root/README.md

# EuAndreh's package-repository

Personal package repository for a variety of operating systems, mainly for 
packaging personal projects of mine and make it available for users and 
packagers.

See the list of packages in [`paku.json`].

[`paku.json`]: https://git.euandreh.xyz/package-repository/tree/paku.json


## How to add this to different OSes

### Guix

Add this channel to your `~/.config/guix/channels.scm`:

```scheme
(cons*
 (channel
  (name 'xyz-euandreh)
  (url "git://euandreh.xyz/package-repository")
  (branch "main")
  (introduction
   (make-channel-introduction
    "d749e053e6db365069cb9b2ef47a78b06f9e7361"
    (openpgp-fingerprint
     "5BDA E9B8 B2F6 C6BC BB0D  6CE5 81F9 0EC3 CD35 6060"))))
 %default-channels)
```

See also the Guix manual for usage on channels: <https://guix.gnu.org/manual/en/guix.html#Channels>

### NixOS

Adding the overlay to your `/etc/nixos/configuration.nix`:

```nix
  nixpkgs = {
    overlays = [
      (import (fetchTarball {
        url = "https://git.euandreh.xyz/package-repository/snapshot/package-repository-main.tar.gz";
      }) { inherit pkgs; })
    ];
  };
```

<!--
### Debian

```shell
$ wget -O- https://package-repository.euandreh.xyz/EuAndreh.key | sudo apt-key add -
$ sudo apt-add-repository 'deb https://package-repository.euandreh.xyz/debian/ stable main'
```
-->


## Contributing

For running the extra development-only checks, run:

```shell
$ make dev-check
```

and for generating the documentation HTML and website, run:

```shell
$ make public
```

Send contributions to the [mailing list] via [`git send-email`](https://git-send-email.io/).


## Links

- [homepage](https://euandreh.xyz/package-repository/)
- [source code](https://git.euandreh.xyz/package-repository/)
- [bug tracking](https://euandreh.xyz/package-repository/TODOs.html)
- [mailing list]
- [CI logs](https://euandreh.xyz/package-repository/ci.html)
- [CHANGELOG](https://euandreh.xyz/package-repository/CHANGELOG.html)

[mailing list]: https://lists.sr.ht/~euandreh/public-inbox?search=%5Bpackage-repository%5D


## License

The code is licensed under [GNU Affero General Public License v3.0 or later][AGPL-3.0-or-later] (AGPL-3.0-or-later).

[AGPL-3.0-or-later]: https://git.euandreh.xyz/package-repository/tree/COPYING