ServeMSX

Your content server for MediaStation X
It is under development, for testing purposes only

Functionality

Now:

• Serves local video & audio files
• Serves local torrent files (TorrServer need to be used)
• Serves TorrServer's torrents (TorrServer need to be used)
• Serves plugins, written on Tengo language (see Plugins Development Manual)
• One plugin is dveloped for example: tivix

In development:

• Plugins installation (and updates) automation
• Self update automation

To do:

• More plugins

Installation

Choose the apropriate file for your OS/Architecture from the releases, download it and just run.
It can be also installed as a service:

• For Windows, please use NSSM.
• For Linux use native service manager, for example, for Systemd you can:
  1. download file ServeMSX.linux.* from the lates releas
  2. rename it to ServeMSX and put it to the folder /opt/ServeMSX/
  3. use the the file: ServeMSX.service, put it to /etc/systemd/system/
  4. run command:

     # systemctl enable ServeMSX && systemctl start ServeMSX

• For OS X use native service manager Launchd, for example, you can:
  1. download the file (ServeMSX.darwin.amd64 for intel processors, ServeMSX.darwin.arm64 for Apple M1 processors) from the latest release
  2. rename it to ServeMSX and put to the folder /opt/ServeMSX/
  3. use the file: damia.ServeMSX.daemon.plist, put it to /Library/LaunchDaemons/
  4. run command:

     # launchctl load /Library/LaunchDaemons/damiva.ServeMSX.daemon.plist

Run paramters:

ServeMSX [options]
Where [options] can be one or more of:

• [IP]<:PORT> - the address of the http server is listen to (default is :8008)
• -i - do not log info messages (recomended to reduce log size)
• -t - do not print timestamp in logs (useful for systemd service manager)
• -s - skip verifying TLS sertificates (useful for tiny OS, like on routers)
• -d - use the directory of execution as working directory (default is current working directory)

Note for running as service:

• Errors logs to STDERR,
• Info messages logs to STDOUT,
• It should be restarted on successful (code 0) exit, becuse it exits succesfully only when it is restarting (manually from MSX or for self updating)

Setup

Media Station X

Install MediaStation X on your TV, run it, go to Settings -> Start Parameter -> Setup and enter the address (default port is 8008) of the machine where ServeMSX is running.

Local media files

In the working directory of ServeMSX, create symbolic links with the following name to your folder:

• for video files: video
• for music files: music
• for image files: photo

Torrents

To play torrents online, you should install and use TorrServer.
In the ServeMSX on Media Station X goto Settings -> TorrServer and enter the address (default port is 8090) of the machine where TorrServer is running (if it is the same maching with ServeMSX, it will be detected automatically).

Plugins

For now, installation of the plugins is manual:

• download the plugins (mentioned above)
• in the working dir of ServeMSX create the folder plugins and put there the plugins (e.g. plugins/tivix/)