Getting started

This page covers running the AnyStream server manually. See Installation > Docker to use the containerized server.

Read this first

AnyStream is a private streaming service for your media files. Third party APIs and optional external applications are used to improve the quality of your collection. You are responsible for operating any external applications that AnyStream communicates with while managing your collection.

To maintain privacy it is recommended that you run AnyStream with a VPN like AirVPN or Mullvad.

Requirements

Java 11+

Windows

Install Manually

Download the JRE 11 MSI file and run the installer. Follow the instructions until the installation is complete. For more information see "Install Azul Zulu with MSI installer"

Install with Chocolatey

choco install zulu --version=11.29.11

macOS

Install Manually

Download the JRE 11 for Intel DMG file or JRE 11 for M1. Double click the file and follow the instructions until the installation is complete.

Install with Homebrew

brew tap mdogan/zulu
brew install zulu-jdk11

Install with MacPorts

sudo port install openjdk11-zulu

FFmpeg

FFmpeg is required to transcode your media library when streaming to certain devices and analyzing media files.

Windows

Install Manually

Click here to download FFmpeg. Extract fmpeg-n4.4-latest-win64-gpl-4.4.zip and rename the bin folder to ffmpeg and move it to C:\Program Files\ffmpeg.

Install with Chocolatey

choco install ffmpeg

macOS

Install Manually

Click here to download FFmpeg and here to download FFprobe. Extract both files into /usr/local/bin

Install with Homebrew

brew install ffmpeg

Install with MacPorts

sudo port install ffmpeg

Download AnyStream

Stay up-to-date

It is recommended the latest version of AnyStream is used at all times, but older versions are available on the Releases page if required.

One download for any Operating System

The AnyStream server runs on Linux, macOS, or Windows with one download, you do not need a version specifically for your operating system.

The latest release can be viewed on the Github Release page or choose your preferred format below:

Download ZIP	Download TAR
anystream-server-1.0.0-SNAPSHOT.zip	anystream-server-1.0.0-SNAPSHOT.tar

Installation

AnyStream tries to provide optimal default configuration and can be run without any configuration.

Configuration (Environment variables)

The following optiions can be modified on your first run to customize AnyStream for your system.

name	value	description
`PORT`	`8888`	The port used to serve the web client and API.
`DATA_PATH`	macos = `/Users/<user>/anystream` linux = `/home/<user>/anystream` windows = `C:\Users\<user>\anystream`	The folder where all data generated by anystream will be stored. Note this is not the folder for your media collection.
`DATABASE_URL`	`sqlite:<DATA_PATH>/config/anystream.db`	The file where the database will be stored. (Note the `sqlite:` prefix is required)
`FFMPEG_PATH`	macos = `/usr/bin` linux = `/usr/bin` windows = `C:\Program Files\ffmpeg`	The directory which contains FFmpeg and FFprobe binaries.
`WEB_CLIENT_PATH`	(none)	The folder which contains the Web client files to be served. By default these files are provided by the server binary.

Configuration (Program arguments)

If preferred, AnyStream accepts arguments instead of Environment variables. The table below maps the Environment variable name to the CLI argument, see "Configuration (Environment variables)" for descriptions of each option.

Env Name	CLI Argument
`PORT`	`-port=8888`
`DATA_PATH`	`-app.dataPath="..."`
`DATABASE_URL`	`-app.databaseUrl="..."`
`FFMPEG_PATH`	`-app.ffmpegPath="..."`
`WEB_CLIENT_PATH`	`-app.webClientPath="..."`

Run on Windows

Newer versions of Windows 10 include curl and tar, if you're running an older version of Windows, follow the "Manual Download" section. Otherwise, see the "Command Prompt Download" section.

Manual Download

Download anystream-server-1.0.0-SNAPSHOT.zip
Right click anystream-server-1.0.0-SNAPSHOT.zip, click "Extract All...", then click "Extract" when the window appears
Open the anystream-server-1.0.0-SNAPSHOT/bin folder
Double click on anystream.bat

You will see a Command Prompt window appear, displaying log messages from AnyStream.

Command Prompt Download

> curl -LO https://github.com/DrewCarlson/AnyStream/releases/download/v1.0.0-SNAPSHOT/anystream-server-1.0.0-SNAPSHOT.tar
> tar -xvf anystream-server-1.0.0-SNAPSHOT.tar
> cd anystream-1.0.0-SNAPSHOT/bin
> anystream -port=8888 -P:app.ffmpegPath="C:\Users\<user>\Downloads\ffmpeg"

AnyStream will be running and printing log messages until you close the window or press ctrl + c.

Run on Linux or macOS

anystream from Terminal example

$ curl -LO https://github.com/DrewCarlson/AnyStream/releases/download/v1.0.0-SNAPSHOT/anystream-server-1.0.0-SNAPSHOT.tar
$ tar -xvf anystream-server-1.0.0-SNAPSHOT.tar
$ cd anystream-1.0.0-SNAPSHOT/bin
$ ./anystream -port=8888

Configure Server

Now your server is running and ready to be used! See Installation > Configure Server for what to do next.