whatisgithub

What is remoplayer?

nima-globals/remoplayer — explained in plain English

Analysis updated 2026-05-18

16PythonAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

A Windows desktop app that plays internet radio stations and local music files with full system media widget integration.

Mindmap

mindmap
  root((RemoPlayer))
    What it does
      Plays internet radio stations
      Plays local music files
      Integrates with Windows media widget
    Tech stack
      Python
      PyQt6
      LibVLC
    Use cases
      Listen to online radio stations
      Play a local music folder
      Control playback with media keys
    Audience
      General Windows users
      Music and radio listeners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Listen to internet radio stations from a native Windows desktop app.

USE CASE 2

Play a local folder of mp3, flac, or wav files with automatic cover art.

USE CASE 3

See the currently playing song in the Windows media widget and control it with media keys.

USE CASE 4

Route audio streams through a proxy when a direct connection is not available.

What is it built with?

PythonPyQt6LibVLC

How does it compare?

nima-globals/remoplayer920linjerry-stack/capital-studioadya84/ha-world-cup-2026
Stars161616
LanguagePythonPythonPython
Setup difficultyeasyeasyeasy
Complexity2/53/52/5
Audiencegeneralresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires VLC Media Player installed on Windows, running from source also needs Python 3.10 or newer.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

RemoPlayer is a desktop app for Windows that combines two things people often want separately: listening to internet radio stations and playing music files stored on your own computer. It uses the VLC playback engine under the hood, so it can play nearly any common audio format without extra setup. For radio, you can listen to dozens of built in online stations or add your own by entering a stream address. For local music, it plays mp3, wav, flac, and ogg files from any folder, showing the album cover, artist, and album name automatically, along with a progress bar for jumping around within a track. On the Windows side, RemoPlayer connects to the built in system media widget, so the currently playing song title, artist, and cover art show up in the same place native Windows media players appear, and the play, pause, and stop buttons, including media keys on a keyboard, work correctly. It also sends a Windows notification whenever a radio station switches to a new song, keeps a history of everything you have listened to, and can optionally launch itself automatically when Windows starts up. It supports routing audio streams through an HTTP or SOCKS5 proxy if needed, and shows a live estimate of how much data you have used and how long you have been listening. Most people are expected to just download the finished RemoPlayer.exe from the releases page and run it directly, with no Python installation required. The only outside requirement is having VLC Media Player installed on the system, since that supplies the actual audio engine. Anyone who wants to run it from source instead needs Windows 10 or 11, Python 3.10 or newer, and VLC installed, then can clone the repository, install the listed dependencies, and run the main script. All settings, including saved radio stations, the music folder, proxy details, and notification preferences, are managed through an in app settings dialog and stored in a local configuration file.

Copy-paste prompts

Prompt 1
Walk me through installing VLC Media Player and running RemoPlayer.exe on Windows.
Prompt 2
Help me set up RemoPlayer from source on Windows with Python 3.10.
Prompt 3
Show me how to add a custom internet radio stream to RemoPlayer's station list.
Prompt 4
Explain how RemoPlayer's SMTC integration makes it show up in the Windows media widget.

Frequently asked questions

What is remoplayer?

A Windows desktop app that plays internet radio stations and local music files with full system media widget integration.

What language is remoplayer written in?

Mainly Python. The stack also includes Python, PyQt6, LibVLC.

What license does remoplayer use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is remoplayer to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is remoplayer for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.