Configuration¶

Minimal setup¶

For a minimal prosody <https://prosody.im> based setup, add these lines at the bottom of /etc/prosody/prosody.cfg.lua:

Component "slidcord.example.org"
    component_secret = "secret"

And start slidcord with:

slidcord \
  --jid slidcord.example.org \
  --secret secret \
  --home-dir /somewhere/writable

Refer to the slidge admin docs for more advanced setups and examples of configuration for other XMPP servers.

You will probably want to add support for attachments received from Discord, and setup slidcord as a privileged component for better UX.

slidcord provides the additional component-wide options displayed in the table below. They can be used:

in an INI config file by starting slidcord with -c /path/to/file.ini;
as command line arguments, prepended with --, e.g., --some-option=value;
as environment variables, upper case, prepended with SLIDCORD_, and with dashes substituted with underscores, e.g., SLIDCORD_SOME_OPTION=value.

name	default	help
auto-fetch-friends-bio	False	If set to true, slidcord will automatically fetch the 'bio' of your discord friends on startup, to push VCards4 to you. Disabled by default because of the rate limiting it triggers for some users.
convert-stickers	True	Convert incoming animated stickers to webm videos. Requires lottie_to_webm.sh in $PATH, cf <https://github.com/ed-asriyan/lottie-converter>, along with FFMPEG.
convert-stickers-executable	lottie_to_webm.sh	Path to the TGS/webm converter executable.
convert-stickers-fps	60	Framerate of the video stickers
convert-stickers-size	128	Width and height video stickers.
discord-verbose	False	Let the discord lib at the same loglevel as others loggers. By default, it's set it to WARNING because it's really verbose.
muc-back-fill	50	The number of messages to fetch in text channels on slidge startup.