This repository has been archived on 2021-01-16. You can view files and clone it, but cannot push or open issues/pull-requests.
satyr/docs/USAGE.md

43 lines
2.2 KiB
Markdown
Raw Normal View History

2019-10-21 14:18:32 -05:00
## Satyr Usage
### Administration
Satyr needs access to port 1935 for RTMP streams, and will serve HTTP on port 8000. See CONFIGURATION.md for details on changing this.
2019-10-21 14:18:32 -05:00
2020-10-17 22:23:05 -05:00
For HTTPS, run a reverse proxy in front of satyr. An example nginx config can be found at install/satyr.nginx
An example systemd service can also be at install/satyr.service
#### CLI
Satyr's CLI tool can be run with `npm run cli` or `node_modules/.bin/ts-node src/cli.ts`
It's not very complex. The following commands are available:
* `npm run cli -- --adduser sally --password "hunter12"` to create user sally with the password hunter12
* `npm run cli -- --rmuser sally` to remove user sally
* `npm run cli -- --invite` to generate an invite code used for creating account even when registration is closed
2019-10-21 14:18:32 -05:00
### Users
#### Accounts
2020-10-18 02:16:54 -05:00
If registration is open, users can register at your.site.com/registration, and set some options such as whether to record VODs and a stream title on /profile.
2019-10-21 14:18:32 -05:00
#### Chat
Chat is based on Socket.IO, and can be accessed through the webclient at /chat.
Chatting and changing a nickname do not require authentication, but the usernames of streamers are reserved.
2020-10-17 22:23:05 -05:00
2019-10-21 14:18:32 -05:00
The following commands are available:
2020-10-17 22:23:05 -05:00
* `/nick sally (password)` Password is only required if sally is a registered user.
* `/join sally` Join the chatroom for sally's stream and leave the previous room.
* `/kick bob` Available only in your own room if you are a streamer. Forcefully disconnect the user.
* `/ban bob (time)` Ban a user from your room. Bans are based on IP address. The optional time is in minutes. The default is 30.
* `/banlist` List the IPs currently banned from your room.
* `/unban (ip)` self explanatory
2019-10-21 14:18:32 -05:00
2020-06-27 23:27:47 -05:00
You can set up mirroring to and from webchat rooms and IRC channels, twitch streams, and discord server channels.
More information is in CONFIGURATION.md
2019-10-21 14:18:32 -05:00
#### Streaming
Users should stream to rtmp://example.tld/stream/examplestreamkey
2020-06-27 23:27:47 -05:00
The stream will be available at rtmp://example.tld/live/kawen and http://example.tld/live/kawen/index.mpd
2019-10-21 14:18:32 -05:00
Most software, such as OBS, will have a separate field for the URL and stream key, in which case the user can enter rtmp://example.tld/stream/ and the stream key in the appropriate field.