Skip to content

damiva/ServeMSX

Repository files navigation

ServeMSX

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

Functionality

Now:

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 - log info messages (they are not logged by default)
  • -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)
  • +f - log ffmpeg messages (they are not logged by default)
  • [int] - seconds to wait for performing service restart and ffmpeg execution (default is 1, if you have more slowly machine please set more)

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 a browser go to Web UI: http://{IP}:8008 and set the folders (on server side).

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

In a browser go to Web UI: http://{IP}:8008 and add plugins (.tgz files).

FFmpeg featuries

Install ffmpeg on the same machine where ServeMSX is running. If your ffmpeg installation has another command to execute (default is ffmpeg) please set it in Web UI settings.