discord-jellyfin-bot/README.md

68 lines
1.7 KiB
Markdown
Raw 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-15 23:57:55 +01:00
[circleci-image]: https://img.shields.io/circleci/build/github/nestjs/nest/master?token=abc123def456
[circleci-url]: https://circleci.com/gh/nestjs/nest
2022-08-07 21:53:30 +02:00
2022-12-15 23:57:55 +01:00
<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>
2022-08-07 21:53:30 +02:00
2022-12-15 23:57:55 +01:00
<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>
</p>
2020-10-26 13:06:34 +01:00
2022-12-15 23:57:55 +01:00
<br/>
<br/>
<hr/>
<br/>
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
2022-12-15 23:57:55 +01:00
- Leighweight and extendable using the [Nest](https://github.com/nestjs/nest) framework
- Easy ussage with Discord commands system (eg. ``/play``, ``/pause``, ...)
- Fast configuration via environment variables
- Typesafe for faster and easier development
2020-10-26 13:00:40 +01:00
2022-12-15 23:57:55 +01:00
## 🚀 Installation
2020-10-05 23:46:32 +02:00
```bash
2022-12-15 23:57:55 +01:00
$ git clone https://github.com/manuel-rw/jellyfin-discord-music-bot.git
$ cd jellyfin-discord-music-bot/
$ yarn
$ yarn start:prod
```
2020-09-25 13:54:28 +02:00
2022-12-15 23:57:55 +01:00
> Docker container comming soon
2020-10-05 23:39:59 +02:00
2022-12-15 23:57:55 +01:00
## 💻 Development
2020-09-25 13:54:28 +02:00
2022-12-15 23:57:55 +01:00
I'm open to any contributions to this project. You can start contributing using the following commands, after executing the installation commands:
2020-09-25 13:54:28 +02:00
2020-10-05 23:46:32 +02:00
```bash
2022-12-15 23:57:55 +01:00
# development
$ npm run start
# watch mode
$ npm run start:dev
# production mode
$ npm run start:prod
2020-09-25 13:54:28 +02:00
```
2022-12-15 23:57:55 +01:00
2020-10-05 23:46:32 +02:00
```bash
2022-12-15 23:57:55 +01:00
# unit tests
$ npm run test
2020-09-25 13:54:28 +02:00
2022-12-15 23:57:55 +01:00
# e2e tests
$ npm run test:e2e
2020-09-25 13:54:28 +02:00
2022-12-15 23:57:55 +01:00
# test coverage
$ npm run test:cov
```
2022-12-16 21:21:26 +01:00
## 👤 Credits
- https://tabler-icons.io/ (MIT)
- https://docs.nestjs.com/ (MIT)
- https://discord.js.org/ (Apache 2.0)