2019-10-05 15:11:03 -05:00
|
|
|
## Configuring Satyr
|
|
|
|
|
|
|
|
|
|
### Config file
|
2019-12-21 17:23:00 -06:00
|
|
|
All changes to satyr's config will go in the config/config.yml file
|
2019-10-05 15:11:03 -05:00
|
|
|
Some values you might want to change are
|
|
|
|
|
```
|
2019-12-21 17:23:00 -06:00
|
|
|
satyr:
|
|
|
|
|
registration: true
|
2019-12-05 18:37:26 -06:00
|
|
|
# allow new users to register
|
|
|
|
|
|
2019-12-21 17:23:00 -06:00
|
|
|
http:
|
|
|
|
|
hsts: true
|
2019-12-05 18:37:26 -06:00
|
|
|
# enable strict transport security
|
|
|
|
|
|
2019-12-21 17:23:00 -06:00
|
|
|
media:
|
|
|
|
|
record: true
|
2019-12-05 18:37:26 -06:00
|
|
|
# allow users to record VODs
|
|
|
|
|
|
2019-12-21 17:23:00 -06:00
|
|
|
transcode:
|
|
|
|
|
adapative: true
|
2020-06-27 23:27:47 -05:00
|
|
|
# enable adaptive livestreaming when transcoding to mpeg-dash
|
|
|
|
|
# this will help users with poor connections, but is very cpu intensive
|
2019-12-05 18:37:26 -06:00
|
|
|
# even 3 variants will max out most budget VPSs with a single stream
|
2019-12-21 17:23:00 -06:00
|
|
|
variants: 3
|
2020-06-27 23:27:47 -05:00
|
|
|
# the number of stream variants to generate when transcoding
|
|
|
|
|
# satyr will generate one source quality variant, and the remaining
|
|
|
|
|
# variants will be of incrementally lower quality and bitrate
|
2019-12-05 18:37:26 -06:00
|
|
|
|
2020-08-08 23:08:09 -05:00
|
|
|
inputflags: ""
|
|
|
|
|
# additional flags to apply to the input during transcoding
|
|
|
|
|
outputflags: ""
|
|
|
|
|
# additional flags to apply to the output during transcoding
|
|
|
|
|
|
|
|
|
|
# hardware acceleration is a bit difficult to configure programmatically
|
|
|
|
|
# this is a good place to do so for your system
|
|
|
|
|
# https://trac.ffmpeg.org/wiki/HWAccelIntro is a good place to start
|
|
|
|
|
|
2020-06-27 23:27:47 -05:00
|
|
|
# having more than 4-5 variants will start giving diminishing returns on stream quality for cpu load
|
|
|
|
|
# if you can't afford to generate at least 3 variants, it's reccomended to leave adaptive streaming off
|
2019-12-05 18:37:26 -06:00
|
|
|
|
2019-12-21 17:23:00 -06:00
|
|
|
crypto:
|
|
|
|
|
saltRounds: 12
|
2020-06-27 23:27:47 -05:00
|
|
|
# change the number of rounds of bcrypt to fit your hardware
|
|
|
|
|
# if you don't understand the implications, don't change this
|
2019-12-05 18:37:26 -06:00
|
|
|
|
2020-06-27 23:27:47 -05:00
|
|
|
chat:
|
|
|
|
|
# the following settings are for chat mirroring bots
|
|
|
|
|
# users will still need to choose which channel to mirror
|
|
|
|
|
# for their chat at /profile/chat
|
|
|
|
|
irc:
|
|
|
|
|
enabled: true
|
|
|
|
|
# enable irc mirroring
|
|
|
|
|
server: chat.freenode.net
|
|
|
|
|
port: 6697
|
|
|
|
|
tls: true
|
|
|
|
|
# settings for the server the IRC bot will connect to
|
|
|
|
|
nickname: 'satyrchat'
|
|
|
|
|
sasl: true
|
|
|
|
|
password: 'definitelyrealpassword'
|
|
|
|
|
# if you want the bot to authenticate itself to reserve the username
|
|
|
|
|
|
|
|
|
|
discord:
|
|
|
|
|
enabled: true
|
|
|
|
|
# enabled discord integration
|
|
|
|
|
token: abcdefghijklmnopqrstuvwxyz
|
|
|
|
|
# the access token for the bot
|
|
|
|
|
# note that the bot will mirror every channel matching the name the user has chosen
|
|
|
|
|
# even if it's connected to multiple servers
|
|
|
|
|
|
|
|
|
|
twitch:
|
|
|
|
|
enabled: true
|
|
|
|
|
username: satyrchataccount
|
|
|
|
|
token: asdfghjklASDFGHJKL
|
|
|
|
|
# access token for the twitch chat bot
|
|
|
|
|
# this is not the account password, you will need to generate a token here:
|
|
|
|
|
# https://twitchapps.com/tmi/
|
2019-10-05 15:11:03 -05:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Web Frontend
|
|
|
|
|
If you want to customize the front-end css, place a file with any changes you wish to make at site/local.css
|
2019-12-05 18:37:26 -06:00
|
|
|
You can change the logo by replacing site/logo.svg.
|
2020-06-27 23:27:47 -05:00
|
|
|
You should also consider editing templates/about.html and templates/tos.html
|
