Nix wrapper for maunium/stickerpicker
Go to file
teutat3s 85716a9e30
Update README with manual steps
2024-04-30 00:45:16 +02:00
python refactor: only download stickers with nix, 2024-04-29 00:12:49 +02:00
uploaded-packs stickers: add more signal stickers 2024-04-30 00:19:24 +02:00
.gitignore refactor: only download stickers with nix, 2024-04-29 00:12:49 +02:00
LICENSE Initial commit 2023-01-02 02:20:02 +01:00
README.md Update README with manual steps 2024-04-30 00:45:16 +02:00
downloadStickers.nix refactor: only download stickers with nix, 2024-04-29 00:12:49 +02:00
fetchers.nix refactor: only download stickers with nix, 2024-04-29 00:12:49 +02:00
flake.lock refactor: only download stickers with nix, 2024-04-29 00:12:49 +02:00
flake.nix refactor: only download stickers with nix, 2024-04-29 00:12:49 +02:00

README.md

built with nix

maunium-stickerpicker-nix

Nix wrapper for maunium/stickerpicker customized for pub.solar.

Usage:

Overview of steps:

  1. Download additional stickers manually from signalstickers.org
  2. (Optional) Define desired stickers in flake.nix as type chatsticker
  3. (Optional) Build .#pub-solar-stickers
  4. Create config.json with @stickerbot Matrix access token
  5. Upload stickers to matrix @stickerbot user's media and store thumbnail URLs in *.json files
  6. Include *.json files in host config flake, see example

config.json example:

{
  "homeserver": "https://matrix.your.domain",
  "user_id": "@stickerbot:matrix.your.domain",
  "access_token": "<stickerbot-matrix-access-token>"
}

Commands:

# Enter nix devshell
nix develop

# Get URL from button on signalstickers.org -> "Add to Signal" -> Right-Click -> "Copy Link"
# Repeat for each signal sticker pack
python -m sigstickers --pack 'https://signal.art/addstickers/#pack_id=7d4893e5bb03ad6ec5f8a5effbdada62&pack_key=fa9893126e26c0d28ed332c08c99f13700497c1fe15980d5069f6c4e48b619ee'
sticker-pack --config config.json --add-to-index ./uploaded-packs/ --title "lindner" downloads/Lindner/png/

# Move images around, json "id" gets set from dirname
for dir in $(ls ./downloads); do mv ./downloads/$dir/png/* ./downloads/$dir/; done
for dir in $(ls ./downloads); do rm -r ./downloads/$dir/gif ./downloads/$dir/png ./downloads/$dir/webp; done

# Upload stickers to matrix and generate json files with thumbnail URLs
for dir in $(ls ./downloads); do sticker-pack --config config.json --add-to-index ./uploaded-packs/ --title "$dir" ./downloads/$dir; done

# Add json files to git, commit and push changes
git add uploaded-packs/
git commit
git push

Here's an example of a stickerpicker config in this flake


Afterwards, you can easily host it in an nginx config

{ ... }:
{
services.nginx.enable = true;
services.nginx.virtualHosts."stickers.myhost.org" = {
    forceSSL = true;
    enableACME = true;
    root = pkgs.element-stickerpicker;
  };
}

List of available fetchers

Site Type Name Required Arguments
<local dir> directory src (path to a local dir with image files)
https://chatsticker.com chatsticker name (see url)

Some notes

To use this, leave the sha256 empty at first, build the stickerspicker with whatever stickers you'd like, and paste the sha256 from the error message back into your code.

Normally, maunium/stickerpicker would cache the stickers in a config file, and reuse the config file on the next run in order not to. This does not work with Nix' determinism. Thus every time you want to add just 1 more stickerpack (or any other kind of edit), this will reupload all stickers. In order to make it easier to delete all sticker once in a while, I would recommend creating a separate user (I've called mine stickerbot), whose only purpose is to be the owner of a bunch of sticker media files. Whenever you want to clean up the media store, just delete all the media file of stickerbot (THIS WILL BREAK OLDER MESSAGES)