# Poke

> Self-hosted, open-source YouTube frontend built on the Invidious API that also offers private weather, translation and maps, with Return YouTube Dislikes and PWA install.

- **Category:** [Video Streaming](https://selfhost.directory/video-streaming)
- **Licence:** GPL-3.0-or-later
- **Source model:** Open source
- **Latest version:** stable-2026a
- **Author:** ashley0143
- **Platforms:** Docker, Docker Compose, Node.js
- **Ports:** 6003 (HTTP port the Poke server listens on)
- **Requires:** Invidious companion, Invidious
- **Tags:** Privacy, Videos, Music, Pwa, Maps, Translation, Weather, Node.js, Invidious, Youtube Frontend

## What is Poke?

Poke (formerly PokeTube) is a free-software web frontend for YouTube, built on top of the Invidious API, that also bundles a weather app, a translator and a map app in a single anonymous interface. Self-hosted instances can show Return YouTube Dislike counts, let users subscribe to channels with their own accounts, customize the look, and add ambient mode plus audio boost and normalization; the project states it uses only free-software codecs with no non-free components. Operators install it from the Codeberg or GitHub repo with npm and start it with `node server.js`, listening on port 6003, after pointing the config file at an Invidious instance, its API URL and an Invidious Companion proxy; a Dockerfile and docker-compose.yml are in the repo, though no container image is published. A PWA manifest lets it be installed on phones, and the maintainer runs a public instance at poketube.fun. Licensing is GPL-3.0-or-later for the main parts, with separate licences for some sections (including the logo), and the codebase includes some LLM-assisted contributions under a published policy.

## Should you self-host Poke?

Poke scores **32/100** on selfhost.directory ([how scoring works](https://selfhost.directory/scoring)) and ranks **#35 of 38** in [Video Streaming](https://selfhost.directory/video-streaming).

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. It is GPL-3.0-or-later-licensed.

Its closest alternative on selfhost.directory is [iSponsorBlockTV](https://selfhost.directory/project/isponsorblocktv) (74/100, 7 217 stars). It scores higher overall, so compare the two before you pick. [See Poke vs iSponsorBlockTV side by side.](https://selfhost.directory/compare/isponsorblocktv-vs-poke)

## Features

- Ambient mode and audio normalization
- Anonymous YouTube frontend
- Channel subscriptions
- Free-codec playback only
- Interface customization
- Maps
- Return YouTube Dislikes
- Translation
- Weather app

## How to install Poke

### Install Poke with Docker

## To build the image, run:
## docker build -t poketube .

## To run the image, run:
## docker run -d  -p 6003:6003 poketube

Note: Image must be built locally from the repo Dockerfile; no published image.

### Install Poke with Docker Compose

# To run, please do either docker compose up -d (for docker's own version) or docker-compose up -d (for your OSes package managers verison)

Note: Compose file mounts ./config.json and maps port 6003; its image lines are commented out.

### Install Poke with Node.js

1. **Install Packages**
   - Fedora/RHEL GNU/linux: `$ sudo dnf install git make gcc libcurl nodejs python libcurl g++ curl-config`
   - Debian/Ubuntu GNU/linux: `$ sudo apt install git make gcc libcurl4-openssl-dev nodejs npm python g++`
   - Alpine Linux (non-gnu): `$ apk add git nodejs npm python make gcc g++ libcurl curl-dev`

2. **Clone Repo**
   - Codeberg: `$ git clone https://codeberg.org/ashleyirispuppy/poke.git`
   - GitHub: `$ git clone https://github.com/ashley0143/poke.git`

3. **Install Dependencies**
   - `$ cd poke`
   - `$ npm install`

4. **Start Server**
   - `$ node server.js`

Note: Then configure an Invidious instance, its companion proxy and the Invidious API URL; runs on localhost:6003.

## Poke alternatives

- [Invidious](https://selfhost.directory/project/invidious): Open-source AGPL front-end for YouTube: watch without ads, tracking or JavaScript, with own subscriptions, playlists and a REST API; runs via Docker and PostgreSQL. (compare: https://selfhost.directory/compare/invidious-vs-poke)
- [piped](https://selfhost.directory/project/piped): Open-source, self-hosted alternative front end for YouTube: no ads or tracking, with subscription feeds, playlists, SponsorBlock and audio-only playback. (compare: https://selfhost.directory/compare/piped-vs-poke)
- [viewtube](https://selfhost.directory/project/viewtube): Self-hosted YouTube frontend for ad-free viewing with subscriptions, playlists, comments, SponsorBlock, and push notifications. (compare: https://selfhost.directory/compare/poke-vs-viewtube)
- [Materialious](https://selfhost.directory/project/materialious): Open-source, self-hosted material-design frontend for YouTube and Invidious: encrypted subscriptions, SponsorBlock, DeArrow, no ads. Web, desktop & Android TV support. (compare: https://selfhost.directory/compare/materialious-vs-poke)
- [PeerTube](https://selfhost.directory/project/peertube): Open-source, ActivityPub-federated video platform for self-hosted instances: WebRTC P2P streaming, live broadcasts, playlists and moderation tools. (compare: https://selfhost.directory/compare/peertube-vs-poke)
- [SyncTube](https://selfhost.directory/project/synctube): SyncTube is a self-hosted, open-source web service for synchronized video viewing with chat, supporting YouTube, Twitch, Vimeo, and direct media links. (compare: https://selfhost.directory/compare/poke-vs-synctube)
- [pigeon-pod](https://selfhost.directory/project/pigeon-pod): Open-source, self-hosted podcast converter that syncs YouTube and Bilibili channels into private RSS feeds with content filters, media downloads, and multi-user access. (compare: https://selfhost.directory/compare/pigeon-pod-vs-poke)
- [YT Zero](https://selfhost.directory/project/ytzero): Self-hosted YouTube subscription inbox reading RSS feeds to SQLite or PostgreSQL. No API keys, no login required. (compare: https://selfhost.directory/compare/poke-vs-ytzero)

## More in Video Streaming

- [Prism](https://selfhost.directory/project/prism): A self-hosted multistreaming server that forwards one OBS stream to Twitch, YouTube, Kick, and other platforms simultaneously.
- [Rapidbay](https://selfhost.directory/project/rapidbay): Self-hosted, open-source torrent video streaming service: search via Jackett or Prowlarr, auto-convert files and subtitles, then play or cast to Chromecast or Apple TV.
- [Restreamer](https://selfhost.directory/project/restreamer): Open-source, self-hosted live video streaming server with a web UI: ingest via RTMP or SRT, restream to YouTube, Twitch and Vimeo, and embed a player.
- [rtmp-hls-server](https://selfhost.directory/project/rtmp-hls-server): Self-hosted, open-source Docker image for a video streaming server supporting RTMP, HLS and DASH, built on Nginx with nginx-rtmp-module, FFmpeg and web players.
- [RTSPtoWeb](https://selfhost.directory/project/rtsptoweb): Self-hosted Go app that converts IP camera RTSP streams to browser-playable WebRTC, MSE, and HLS formats without FFmpeg.
- [sagetv](https://selfhost.directory/project/sagetv): SageTV is a self-hosted, open-source DVR and media center with client-server architecture, supporting live TV, recordings, and media playback across Windows and Linux.
- [Shinobi](https://selfhost.directory/project/shinobi): Self-hosted, open-source CCTV/VMS written in Node.js: record IP and USB cameras, watch live streams in the browser, motion and AI object detection.
- [SkillGoblin](https://selfhost.directory/project/skillgoblin): Self-hosted video course platform in one Docker container with SQLite. Add video folders, track progress, no cloud. AGPL-3.0.
- [smart-sec-cam](https://selfhost.directory/project/smart-sec-cam): Self-hosted, open-source security camera system for USB or Raspberry Pi cameras with motion detection, video recording, and a web UI — all encrypted with integrated auth.
- [snapify](https://selfhost.directory/project/snapify): Snapify is an open-source, self-hostable Loom alternative for async screen recording and video sharing with public links and auto-expiring recordings.
- [socialstream.ninja](https://selfhost.directory/project/socialstream-ninja): Free, open-source tool that consolidates chat from 100+ streaming platforms into one dashboard with OBS overlays, TTS, AI cohosts, and automation.
- [SRS](https://selfhost.directory/project/srs): Open-source, self-hosted C++ media server for live video over RTMP, WebRTC, HLS, HTTP-FLV, SRT, DASH and GB28181, with Docker and Kubernetes deployment.

## Links

- [Homepage](https://codeberg.org/ashleyirispuppy/poke)
- [Website](https://poketube.fun)
- [Discord](https://discord.poketube.fun/)
- [GitHub mirror](https://github.com/ashley0143/poke.git)
- [PokeSocial (Mastodon)](https://social.poketube.fun)
- [Privacy Policy](https://poketube.fun/privacy)

---
Source: https://selfhost.directory/project/poke