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 [online].

[online]: https://euandre.org/s/package-repository/paku.html


## How to add this to different OSes


### Guix

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

```scheme
(cons*
 (channel
  (name 'org-euandre)
  (url "git://euandre.org/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://euandre.org/git/package-repository/snapshot/package-repository-main.tar.xz";
      }) { inherit pkgs; })
    ];
  };
```


### Debian

```shell
$ wget -qO- https://euandre.org/s/package-repository/debian/public-key.asc | sudo tee /etc/apt/trusted.gpg.d/euandre.org.asc
$ sudo apt-add-repository 'deb https://euandre.org/s/package-repository/debian ./'
```


### Homebrew

```shell
$ brew tap --force-auto-update org/euandre https://euandre.org/git/package-repository/
```


## 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://euandre.org/s/package-repository/en/)
- [source code](https://euandre.org/git/package-repository/)
- [bug tracking](https://euandre.org/s/package-repository/TODOs.html)
- [mailing list]
- [CI logs](https://euandre.org/s/package-repository/ci.html)
- [CHANGELOG](https://euandre.org/s/package-repository/en/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://euandre.org/git/package-repository/tree/COPYING