mirror of
https://github.com/informaticker/discord-jellyfin-bot.git
synced 2024-11-23 18:21:55 +01:00
📝 Update Readme
This commit is contained in:
parent
799f99e261
commit
24fc01e70b
51
README.md
51
README.md
@ -5,10 +5,10 @@
|
|||||||
<br/>
|
<br/>
|
||||||
<h1 align="center">Jellyfin Discord Bot</h1>
|
<h1 align="center">Jellyfin Discord Bot</h1>
|
||||||
|
|
||||||
<p align="center">A simple <a href="https://discord.com" target="_blank">Discord</a> bot that enables you to broadcast your <a href="https://jellyfin.org/" target="_blank">Jellyfin Media Server</a> music collection to voice channels.</p>
|
<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>
|
||||||
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<small>Thanky you KGT1 for starting this project! This is a fork of their original repository and re-uses some of their code.</small>
|
<small>Thanky you <a href="https://github.com/KGT1/jellyfin-discord-music-bot/">KGT1</a> for starting this project!<br/>This is a fork of their original repository and re-uses some of their code.</small>
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
|
|
||||||
@ -21,17 +21,26 @@
|
|||||||
|
|
||||||
- Leighweight and extendable using the [Nest](https://github.com/nestjs/nest) framework
|
- Leighweight and extendable using the [Nest](https://github.com/nestjs/nest) framework
|
||||||
- Easy usage with Discord command system (eg. ``/play``, ``/pause``, ...)
|
- Easy usage with Discord command system (eg. ``/play``, ``/pause``, ...)
|
||||||
- Fast configuration via environment variables
|
- Fast and validated configuration using environment variables
|
||||||
- Typesafe for faster and easier development
|
- Typesafe code for quicker development and less bugs
|
||||||
|
- Supports ``Music``, ``Playlists`` and ``Albums`` from your Jellyfin instance
|
||||||
|
|
||||||
|
## 📌 About this project
|
||||||
|
This project was originally started by [KGT1 on Github](https://github.com/KGT1/jellyfin-discord-music-bot/) in 2020. I came accross this project in late 2021, when wanted to enjoy my music on Discord. I never got it to run as I wanted it to. Since the original project was created under the MIT license, I decided to make a fork in 2022 with my own version. Although this project re-uses some code of the original project, it has been completly rewritten in other parts using NestJs and features now a module-based approach.
|
||||||
|
|
||||||
|
## ⛔ Limitations
|
||||||
|
|
||||||
|
- Bot does not support shards. This means, you cannot use it in multiple servers concurrently.
|
||||||
|
- Displaying media covers or images in Discord (Jellyfin is self hosted, and other users woudln't be able to see those images)
|
||||||
|
- Streaming any video content in voice channels (See [this issue](https://github.com/discordjs/discord.js/issues/4116))
|
||||||
|
|
||||||
## 🚀 Installation
|
## 🚀 Installation
|
||||||
|
|
||||||
```bash
|
Please check out the Wiki section in the repository for installation instructions:
|
||||||
$ git clone https://github.com/manuel-rw/jellyfin-discord-music-bot.git
|
|
||||||
$ cd jellyfin-discord-music-bot/
|
https://github.com/manuel-rw/jellyfin-discord-music-bot/wiki
|
||||||
$ yarn
|
|
||||||
$ yarn start:prod
|
|
||||||
```
|
|
||||||
|
|
||||||
> Docker container comming soon
|
> Docker container comming soon
|
||||||
|
|
||||||
@ -39,28 +48,6 @@ $ yarn start:prod
|
|||||||
|
|
||||||
I'm open to any contributions to this project. You can start contributing using the following commands, after executing the installation commands:
|
I'm open to any contributions to this project. You can start contributing using the following commands, after executing the installation commands:
|
||||||
|
|
||||||
```bash
|
|
||||||
# development
|
|
||||||
$ npm run start
|
|
||||||
|
|
||||||
# watch mode
|
|
||||||
$ npm run start:dev
|
|
||||||
|
|
||||||
# production mode
|
|
||||||
$ npm run start:prod
|
|
||||||
```
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# unit tests
|
|
||||||
$ npm run test
|
|
||||||
|
|
||||||
# e2e tests
|
|
||||||
$ npm run test:e2e
|
|
||||||
|
|
||||||
# test coverage
|
|
||||||
$ npm run test:cov
|
|
||||||
```
|
|
||||||
|
|
||||||
## 👤 Credits
|
## 👤 Credits
|
||||||
- https://tabler-icons.io/ (MIT)
|
- https://tabler-icons.io/ (MIT)
|
||||||
- https://docs.nestjs.com/ (MIT)
|
- https://docs.nestjs.com/ (MIT)
|
||||||
|
Loading…
Reference in New Issue
Block a user