https://github.com/kaiwinter/nfcsonos
Android client to start a Sonos favorite by scanning a NFC tag
https://github.com/kaiwinter/nfcsonos
android nfc sonos sonos-controller
Last synced: 4 months ago
JSON representation
Android client to start a Sonos favorite by scanning a NFC tag
- Host: GitHub
- URL: https://github.com/kaiwinter/nfcsonos
- Owner: kaiwinter
- License: gpl-3.0
- Created: 2021-02-23T10:20:01.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2025-04-19T16:36:09.000Z (about 1 year ago)
- Last Synced: 2025-04-19T19:41:31.415Z (about 1 year ago)
- Topics: android, nfc, sonos, sonos-controller
- Language: Java
- Homepage:
- Size: 1.29 MB
- Stars: 9
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# NFC Controller for Sonos
This app starts a Sonos favorite by scanning a NFC tag.
I started this project to simplify starting audio books on Sonos for the kids. Now they have a set of printed CD covers from which they can choose what they want to listen to.
Choosing the same on the display of a smartphone or tablet always felt odd somehow. Now they can search through their collection of CD cover cards and pick one. By holding the card on a smartphone the Sonos box starts playing the linked album.
## How to
1. Print a CD cover
2. Stick a NFC tag on the back
(I'm using photographic paper for printing. After sticking the NFC tag on the back I glue a cardboard over it.)
Sonos App
3. Create a favorite in the Sonos app for a specific album
NFC Controller App
4. Login with your Sonos credentials
5. Select the Sonos group which the app should control
6. Go to the "Pairing" section
7. Choose the Sonos favorite from the dropdown and hit the "Pair" button
8. Hold the NFC tag on (or behind) the phone to link the tag with the favorite
Now you can put the printed CD cover on your phone to start the album on the Sonos box. The app doesn't have to be started but the screen have to be turned on.
## Technical considerations
### Sonos cloud
The app requires a Sonos login as it controls the box by sending commands to the Sonos cloud.
In an early stage I was using UPNP commands which were sent to the Sonos box directly (no Sonos login necessary). But that turned out as too slow and too unstable.
So I decided to send the commands through the Sonos cloud.
### Need for Sonos favorites
The Sonos Cloud API doesn't allow to play an album from e.g. Spotify in a direct way ([see Stackoverflow](https://stackoverflow.com/a/53733774/714965)). The workaround is to create a Sonos favorite of an album.
## TODO
- Set speaker volume to a level which was configured in the app preferences
## Screenshots
## Credits
Sounds: https://mixkit.co/
CD cover placeholder image: [Designed by rawpixel.com / Freepik](http://www.freepik.com)
App icon made by Flat Icons from www.flaticon.com