mirror of
https://github.com/IrosTheBeggar/mStream.git
synced 2025-10-27 07:31:02 +00:00
71 lines
1.9 KiB
Markdown
71 lines
1.9 KiB
Markdown
## Set Port
|
|
Use the `-p` command to set the port. Will default to 3000 if not set
|
|
|
|
```shell
|
|
mstream -p 5050
|
|
```
|
|
|
|
## SSL
|
|
All you need to do is set the cert and key file and mStream will do the rest
|
|
|
|
```shell
|
|
mstream -c /path/to/cert.pem -k /path/to/key.pem
|
|
```
|
|
|
|
## User System
|
|
mStream can have a single user and guest. If the user is not set mStream will disable to the user system and anyone will be able to access the server
|
|
|
|
```shell
|
|
# Set User
|
|
mstream -u [username] -x [password]
|
|
|
|
# Set user and guest
|
|
mstream -u [username] -x [password] -G [guest name] -X [guest password]
|
|
```
|
|
|
|
#### secret
|
|
|
|
You can set your login secret key with the `-s` command
|
|
```
|
|
mstream -s /path/to/secret/file
|
|
```
|
|
|
|
If not set mStream will generate a random string to use as the secret key on boot. If rebooted, the secret key will be regenerated and any previous keys will no longer work
|
|
|
|
## Database Options
|
|
You can either use mStream's default database [or tap into BeetsDB.](https://github.com/beetbox/beets)
|
|
|
|
#### Beets DB
|
|
|
|
```shell
|
|
mstream -D beets -d /path/to/beets.db
|
|
```
|
|
|
|
When using Beets, mStream is put into a read only mode. mStream will not be able to write to any tables that are managed by Beets. Playlist functionality is not affected by this since playlists are stored in a separate table.
|
|
|
|
|
|
#### Built In DB
|
|
|
|
mStream can read metadata and write it's own database. By default mStream will create a database in the folder it's launched in called 'mstreamdb.lite'. You can manually set the database file with:
|
|
|
|
```shell
|
|
mstream -d /path/to/mstream.db
|
|
```
|
|
|
|
|
|
## Automatically setup port forwarding
|
|
|
|
mStream can try to automatically setup port forwarding via upnp. Use the '-t' command to try to setup port forwarding.
|
|
```
|
|
mstream -t
|
|
```
|
|
|
|
Please note that not all routers will allow this. Some routers may close this port after a period of time.
|
|
|
|
You can get around this by having mStream retry this on a regular interval
|
|
|
|
```
|
|
mstream -t -r [time in milliseconds]
|
|
mstream -t -r 100000
|
|
```
|