SoCo -Download – SoCo Quellcode-Download

SoCo

Anderer Quellcode

SoCo 0.30.6 Release Notes

Herunterladen

SoCo

SoCo (Sonos Controller) ist eine Python-Bibliothek, mit der Sie Sonos-Lautsprecher programmgesteuert steuern können. Es wurde ursprünglich beim Music Hack Day Sydney von Rahim Sonawalla erstellt und wird jetzt von einem Team in seinem GitHub-Repository entwickelt

Weitere Hintergrundinformationen zum Projekt finden Sie in Rahims Blogbeitrag.

Besuchen Sie die SoCo-Dokumentation für einen detaillierteren Überblick über die Funktionalität.

WARNUNG

Sonos hat die Art und Weise geändert, wie Kontoinformationen für Musikdienste verfügbar sind. Dies bedeutet, dass derzeit bei einer Gruppe von Musikdiensten Authentifizierungsprobleme auftreten und diese überhaupt nicht verwendet werden können . Bekannte Mitglieder dieser Gruppe sind: Google Play Music, Apple Music, Amazon Music, Spotify und Napster.

Problem Nr. 557 ist ein Meta-Problem für dieses Problem und Sie können es verwenden, um den Fortschritt bei der Lösung der Probleme zu verfolgen. Bitte posten Sie dort jedoch keine „Ich auch“-Kommentare . Es besteht auch keine Notwendigkeit, hierzu eine weitere gesonderte Ausgabe zu eröffnen. Wenn Sie einen anderen Musikdienst haben, der auf der Liste stehen sollte, kommentieren Sie ihn unter #557

Ab Version 0.26.0 wurde die Unterstützung neuer Musikdienste mit einigen bekannten Problemen wieder aufgenommen. Tests und Problemberichte wären willkommen.

Installation

SoCo erfordert Python 3.6 oder neuer.

Pip verwenden:

pip install soco

SoCo ist auf eine Reihe von Python-Paketen angewiesen. Wenn Sie Soco mit pip installieren, werden die Abhängigkeiten automatisch für Sie installiert. Wenn nicht, können Sie die Anforderungen in der Datei „requirements.txt“ überprüfen.

Grundlegende Verwendung

Sie können über ein SoCo-Objekt mit einem Sonos Zone Player interagieren. Wenn Sie die IP-Adresse eines Zone Players kennen, können Sie direkt ein SoCo-Objekt erstellen:

 >> > from soco import SoCo
>> > my_zone = SoCo ( '192.168.1.101' )
>> > my_zone . player_name
Kitchen
>> > my_zone . status_light = True
>> > my_zone . volume = 6

Der vielleicht einfachste Weg ist jedoch die Verwendung der Erkennungsfunktion auf Modulebene. Dadurch werden alle Zone Player in Ihrem Netzwerk gefunden und ein Python-Set zurückgegeben, das sie enthält:

 >> > from soco import discover
>> > for zone in discover ():
...        print ( zone . player_name )
Living Room
Kitchen

Wenn Sie eine Liste einem Set vorziehen:

 >> > zone_list = list ( discover ())
>> > zone_list
[ SoCo ( "192.168.1.101" ), SoCo ( "192.168.1.102" )]
>> > zone_list [ 0 ]. mute = True

Natürlich können Sie auch Musik abspielen!

 #!/usr/bin/env python
from soco import SoCo

if __name__ == '__main__' :
    sonos = SoCo ( '192.168.1.102' ) # Pass in the IP of your Sonos speaker
    # You could use the discover function instead, if you don't know the IP

    # Pass in a URI to a media file to have it streamed through the Sonos
    # speaker
    sonos . play_uri (
        'http://ia801402.us.archive.org/20/items/TenD2005-07-16.flac16/TenD2005-07-16t10Wonderboy.mp3' )

    track = sonos . get_current_track_info ()

    print ( track [ 'title' ])

    sonos . pause ()

    # Play a stopped or paused track
    sonos . play ()

Unterstützung

Wenn Sie Unterstützung für SoCo benötigen, können Sie Ihre Frage gerne im SoCo Gitter Room posten.

Beispielanwendungen

Um zu zeigen, was mit SoCo möglich ist, ist im examples eine einfache Webanwendung enthalten.

Screenshot der Web-App

Merkmale

SoCo unterstützt unter anderem folgende Kontrollen:

Abspielen, Pause, Stopp
Nächster Titel, Vorheriger Titel
Lautstärke abrufen und einstellen
Stummschalten (oder Stummschaltung aufheben)
Erhalten Sie aktuelle Transportinformationen (ob der Lautsprecher abspielt, pausiert oder gestoppt ist)
Erhalten Sie Informationen zum aktuell wiedergegebenen Titel
- Tracktitel
- Künstler
- Album
- Albumcover (falls verfügbar)
- Spurlänge
- Abgespielte Dauer (z. B. 30 Sekunden in einem 3-minütigen Song)
- Playlist-Position (z. B. Element 5 in der Playlist)
- URI verfolgen
Empfangen Sie Ereignisse, wenn sich der Spielerstatus ändert
Musiktitel suchen und abspielen:
- Lokale Musikbibliothek
- Webradio über TuneIn und Musikdienste (immer noch instabil)
- Gespeicherte Sonos-Favoriten, Lieblingsradiosender und -sendungen
Schalten Sie die Quelle des Lautsprechers auf Line-In oder TV-Eingang um (sofern der Zone Player dies unterstützt).
Verwalten Sie die Sonos-Warteschlange:
- Holen Sie sich die Elemente in die Warteschlange
- Elemente zur Warteschlange hinzufügen
- Löschen Sie die Warteschlange
- Spielen Sie ein bestimmtes Lied aus der Warteschlange
Treten Sie Sprecher einer Gruppe bei oder entfernen Sie sie
Versetzen Sie alle Sonos-Lautsprecher in einem Netzwerk in den „Party-Modus“.
Rufen Sie Alarme ab oder stellen Sie sie ein
Holen Sie sich Sleep-Timer oder stellen Sie sie ein
Aktivieren oder deaktivieren Sie Surround-Lautsprecher oder Subwoofer
Informieren Sie sich über ein Heimkino-Setup:
- Wenn Surround-Lautsprecher oder ein Subwoofer gekoppelt sind
- Welchen Audiokanal ein bestimmter Lautsprecher verarbeitet
Rufen Sie den Bass- und Höhen-EQ des Lautsprechers ab oder stellen Sie ihn ein
Schalten Sie die Lautstärkekompensation, den Nachtmodus und den Dialogmodus des Lautsprechers um
Schalten Sie die weiße Statusleuchte am Gerät ein
Holen Sie sich die Informationen des Redners
- Zonenname
- Zonensymbol
- UID (normalerweise etwa RINCON_XXXXXXXXXXXXXXXXXX)
- Seriennummer
- Softwareversion
- Hardwareversion
- MAC-Adresse
Legen Sie den Zonennamen des Lautsprechers fest
Starten Sie ein Musikbibliotheks-Update und stellen Sie fest, ob gerade ein Update durchgeführt wird