discord-jellyfin-bot/README.md

55 lines
2.3 KiB
Markdown
Raw Permalink Normal View History

2022-08-07 21:53:30 +02:00
<p align="center">
2022-12-15 23:57:55 +01:00
<a href="http://nestjs.com/" target="blank"><img src="https://github.com/walkxcode/dashboard-icons/blob/main/png/jellyfin.png?raw=true" width="200" alt="Nest Logo" /></a>
2022-08-07 21:53:30 +02:00
</p>
2022-12-18 14:10:24 +01:00
<br/>
<h1 align="center">Jellyfin Discord Bot</h1>
2022-08-07 21:53:30 +02:00
2022-12-18 19:58:14 +01:00
<p align="center">A simple <a href="https://discord.com" target="_blank">Discord</a> bot that enables you to broadcast<br/>your <a href="https://jellyfin.org/" target="_blank">Jellyfin Media Server</a> music collection to voice channels.<br/>It's Open Source and can easily be hosted by yourself!</p>
2022-08-07 21:53:30 +02:00
2022-12-15 23:57:55 +01:00
<p align="center">
2024-05-20 01:30:58 +02:00
<small>Thank you <a href="https://github.com/manuel-rw/jellyfin-discord-music-bot/">manuel-rw</a> for forking this project.<br/>This is a fork of their fork and uses most of it's code.</small>
2022-12-15 23:57:55 +01:00
</p>
2020-10-26 13:06:34 +01:00
2020-10-26 13:00:40 +01:00
2022-12-15 23:57:55 +01:00
## ✨ Features
2020-10-26 13:00:40 +01:00
2023-09-03 14:23:11 +02:00
- Lightweight and extendable using the [Nest](https://github.com/nestjs/nest) framework
- Easy usage with Discord command system (eg. ``/play``, ``/pause``, ...)
2022-12-18 19:58:14 +01:00
- Fast and validated configuration using environment variables
- Typesafe code for quicker development and less bugs
- Supports ``Music``, ``Playlists`` and ``Albums`` from your Jellyfin instance
2020-10-26 13:00:40 +01:00
2022-12-18 19:58:14 +01:00
## 📌 About this project
2024-05-20 01:30:58 +02:00
This project is a fork of [manuel-rw's fork of ](https://github.com/manuel-rw/jellyfin-discord-music-bot) [KGT1's fork](https://github.com/KGT1/jellyfin-discord-music-bot/), adding functionality such as presence, defered messages, higher bitrate.
2022-12-18 19:58:14 +01:00
## ⛔ Limitations
2020-09-25 13:54:28 +02:00
2022-12-18 19:58:14 +01:00
- Bot does not support shards. This means, you cannot use it in multiple servers concurrently.
2022-12-25 21:57:37 +01:00
- Album covers are not visible, unless they are remote (eg. provided by external metadata provider)
2022-12-18 19:58:14 +01:00
- Streaming any video content in voice channels (See [this issue](https://github.com/discordjs/discord.js/issues/4116))
2020-10-05 23:39:59 +02:00
2022-12-18 19:58:14 +01:00
## 🚀 Installation
2020-09-25 13:54:28 +02:00
2024-05-20 01:30:58 +02:00
Please check out manuel-rw's Wiki section in his repository for installation instructions:
2020-09-25 13:54:28 +02:00
2022-12-18 19:58:14 +01:00
https://github.com/manuel-rw/jellyfin-discord-music-bot/wiki
2022-12-15 23:57:55 +01:00
2022-12-18 19:58:14 +01:00
## 💻 Development
2020-09-25 13:54:28 +02:00
2024-05-20 01:30:58 +02:00
Clone it, make your changes and create a pull request. Simple as that
2022-12-16 21:21:26 +01:00
## 👤 Credits
2023-09-03 14:23:11 +02:00
2022-12-18 23:27:49 +01:00
- https://tabler-icons.io/
- https://docs.nestjs.com/
- https://discord.js.org/
- https://github.com/fjodor-rybakov/discord-nestjs
- https://github.com/jellyfin/jellyfin-sdk-typescript
- https://jellyfin.org/
- https://github.com/KGT1/jellyfin-discord-music-bot
- https://gitmoji.dev/
2024-05-20 01:30:58 +02:00
- https://github.com/manuel-rw/jellyfin-discord-music-bot