matter_media
matter media
Windows media control bindings (play/pause, next/previous, volume) plus a simple tray app UI that is controlled on your phone via Matter protocol.
limitations
Apple currently has limited matter support in the Home app.
The Home app currently supports these types of Matter accessory: air conditioners, bridges, lights, locks, sockets, switches, thermostats, blinds and shades, and sensors (motion, ambient light, contact, temperature and humidity).
So we mapping these controls to:
- EP1: OnOff Switch = Play/Pause (stateful)
- EP2: Dimmable Light = Volume (LevelControl)
- EP3: OnOff Switch = Next (momentary)
- EP4: OnOff Switch = Previous (momentary)
We'll migrate to something like this once support is added:
- Endpoint 1: Basic Video Player = Media Controls
- Endpoint 2: Speaker = Volume
Usage (Windows)
- Build:
shards build --release - Run:
./bin/matter_media
Tray menu supports: Play/Pause, Next, Previous, Stop, Volume Up/Down, Mute.
Storage
Fabrics, sessions and cluster state are kept in matter_media_storage.yml, next to the executable.
Matter 0.2 changed the storage format, so a device commissioned by an earlier build needs its storage converted once, offline. It stays paired afterwards:
matter-storage migrate --from legacy:matter_media_storage.json --to yaml:matter_media_storage.yml
(matter-storage is built from the matter shard with shards build matter-storage.)
Contributing
- Fork it (https://github.com/spider-gazelle/matter_media/fork)
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request
Contributors
- Stephen von Takach - creator and maintainer
matter_media
- 0
- 0
- 0
- 0
- 1
- 3 days ago
- December 28, 2025
MIT License
Sat, 12 Sep 2026 05:44:02 GMT