Skip to content

ValDesign22/homestream_server

Folders and files

NameName
Last commit message
Last commit date
Jan 25, 2025
Jan 12, 2025
Jan 26, 2025
Aug 14, 2024
Aug 10, 2024
Jan 12, 2025
Aug 20, 2024
Jan 25, 2025
Jan 12, 2025
Jan 12, 2025
Jan 12, 2025
Jan 25, 2025
Jan 25, 2025
Jan 12, 2025

Repository files navigation

NestPlay Server

NestPlay Server is the backend for the NestPlay project.

It lets you stream your media files seamlessly across devices on your local network (or even remotely).

NestPlay is built with Nuxum, a simple and lightweight express server framework. Both projects are open-source and free to use.

Features

  • Stream media files to any device
  • Easy to set up and configure
  • Supports automatic media library updates

Prerequisites

  • Node.js (v18 or newer)
  • FFmpeg (required for video tracks and subtitles)

Installation

From source

To install and run the server from source:

  1. Clone the repository
git clone https://github.com/ValDesign22/nestplay_server.git
cd nestplay_server
  1. Install the dependencies
npm install
  1. Build the project
npm run build
  1. Start the server
npm start

From release

To install and run the server from a pre-built release:

  1. Download the latest release from the releases page
  2. Extract the files and navigate to the extracted folder
  3. Install the dependencies
npm install
  1. Start the server
npm start

Configuration

You can configure the server using environment variables. Create a .env file in the root of the project and add the following variables:

APP_STORAGE_PATH=SERVER_STORAGE # Where the server will store the files
FILES_FOLDER=SERVER_FILES # Where the server will look for the files
PORT=PORT # The port the server will listen on
TMDB_API_KEY=YOUR_TMDB_API_KEY # You can get one from https://www.themoviedb.org/documentation/api
WATCH_DIR=SERVER_WATCH_DIR # The directory the server will watch for new files

Usage

  1. Start the server
  2. Open the client
  3. Connect to the server
  4. Enjoy your media

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License

MIT