StepDaddyLiveHD

repository·master·Indexed 42 days ago

https://github.com/gookie-dev/stepdaddylivehd

A self-hosted IPTV proxy built with the Reflex framework that enables browsing, searching, and streaming over 1,000 TV channels via a web browser or external media players like Jellyfin using a playlist.m3u8 export.

Tokens
1.3K
Snippets
6
Records
7
Agent score
2%

What's inside StepDaddyLiveHD

  1. Overview of StepDaddyLiveHD features and pages

    master

    StepDaddyLiveHD is a self-hosted IPTV proxy that allows you to stream over 1,000 TV channels in your browser or via media players.

    Core Capabilities

    • Stream Anywhere: Web browser or media player client support.
    • Event Search: Search for live events or sports matches.
    • Playlist Integration: Download playlist.m3u8 for use in Jellyfin or other IPTV clients.

    Application Pages

    • Home: Browse and search for TV channels.
    • Live Events: Find channels broadcasting live sports/events.
    • Playlist Download: Access the playlist.m3u8 file.
  2. Install StepDaddyLiveHD locally

    master

    To run the application directly on your machine, follow these steps:

    1. Ensure Python 3.12 is installed.
    2. Clone the repository:
      git clone https://github.com/gookie-dev/StepDaddyLiveHD
      cd StepDaddyLiveHD
    3. Create and activate a virtual environment:
      python -m venv venv
      source venv/bin/activate  # On Windows: venv\Scripts\activate
    4. Install dependencies:
      pip install -r requirements.txt
    5. Initialize the Reflex framework:
      reflex init
    6. Run the application in production mode:
      reflex run --env prod
    python -m venv venv
    source venv/bin/activate
    pip install -r requirements.txt
    reflex init
    reflex run --env prod
  3. Install StepDaddyLiveHD via Docker (Recommended)

    master

    The recommended way to run StepDaddyLiveHD is using Docker or Docker Compose.

    Important for LAN usage: If you intend to access the application from other devices on your local network (LAN), you must set the API_URL environment variable to the local IP address of the host machine in your .env file.

    Using Docker Compose

    1. Ensure Docker and Docker Compose are installed.
    2. Clone the repository and enter the directory.
    3. Run:
    docker compose up -d

    Using Plain Docker

    docker build -t step-daddy-live-hd .
    docker run -p 3000:3000 step-daddy-live-hd
  4. Configure StepDaddyLiveHD via Environment Variables

    master

    You can customize the server behavior using the following environment variables. For Docker Compose, edit the .env file.

    PORT: Set a custom port for the server.
    API_URL: Set the domain or IP where the server is reachable (use local IP for LAN access).
    SOCKS5: Proxy DLHD traffic through a SOCKS5 server (format: user:password@proxy.example.com:1080).
    PROXY_CONTENT: If set, the server will proxy the video content itself (optional).
  5. Build and run StepDaddyLiveHD with custom build arguments and environment variables

    master

    Use --build-arg during the build phase and -e during the run phase to pass configuration like PROXY_CONTENT, API_URL, and SOCKS5 settings.

    docker build --build-arg PROXY_CONTENT=FALSE --build-arg API_URL=https://example.com --build-arg SOCKS5=user:password@proxy.example.com:1080 -t step-daddy-live-hd .
    docker run -e PROXY_CONTENT=FALSE -e API_URL=https://example.com -e SOCKS5=user:password@proxy.example.com:1080 -p 3000:3000 step-daddy-live-hd
  6. Configure StepDaddyLiveHD via Docker Compose

    master

    You can deploy StepDaddyLiveHD using Docker Compose. The service step-daddy-live-hd uses several environment variables for both the build process and the runtime environment. These variables should be defined in a .env file or passed directly to the shell.

    Key configuration variables include:

    • PORT: The port on which the application runs.
    • API_URL: The URL for the API.
    • PROXY_CONTENT: Configuration for proxying content.
    • SOCKS5: Configuration for SOCKS5 proxy settings.
    services:
      step-daddy-live-hd:
        build:
          context: .
          dockerfile: Dockerfile
          args:
            PORT: ${PORT}
            API_URL: ${API_URL}
            PROXY_CONTENT: ${PROXY_CONTENT}
            SOCKS5: ${SOCKS5}
        environment:
          - PORT=${PORT}
          - API_URL=${API_URL}
          - PROXY_CONTENT=${PROXY_CONTENT}
          - SOCKS5=${SOCKS5}
        ports:
          - "${PORT}:${PORT}"
        restart: unless-stopped
        env_file:
          - .env