Skip to main content

Ein kleines Tool, das die Gendersternchen (z.B. Künstler*innen) aus der Spotify-App für Android entfernt.

Project description

Spotify-Gender-Ex

Ein kleines Tool, das die Gendersternchen (z.B. Künstler*innen) aus der Spotify-App für Android entfernt.

Funktionsprinzip

Es ist möglich, mit einem Programm namens apktool Android-Apps zu dekompilieren. An den Quellcode kommt man so nicht ohne weiteres heran, da dieser zu Java-Bytecode kompiliert wurde. Sämtliche Assets (Bilder und eben auch Sprachdateien) lassen sich dagegen problemlos extrahieren.

Der Clou ist, dass apktool dekompilierte Apps auch wieder in eine APK-Datei packen kann. Somit sind Modifikationen an Bildern oder Sprachdateien ohne Probleme möglich. Man kann also die Original Spotify-App dekompilieren, die Sprachdatei öffnen (sie befindet sich unter res/values-de/strings.xml bzw plurals.xml) und diese äußerst kreative Sprachkonstruktion:

<string name="marquee_optout_menu_disclosure_text">Das ist ein neues Musikupdate zu einem/einer Künstler*in, den/die du hörst oder dem/der du folgst. Es wird von einem unserer Musikpartnern gesponsert.</string>

ein wenig vernünftiger formulieren:

<string name="marquee_optout_menu_disclosure_text">Das ist ein neues Musikupdate zu einem Künstler, den du hörst oder dem du folgst. Es wird von einem unserer Musikpartner gesponsert.</string>

Versucht man die so modifizierte und rekompilierte Spotify-App zu installieren, wird die Installation mit einer nichtssagenden Fehlermeldung (App wurde nicht installiert o.ä.) abbrechen. Der Grund hierfür ist, dass Android-Apps vom Entwickler signiert werden müssen, um ihre Authentizität zu gewährleisten.

Die modifizierte App hat noch keine Signatur, deswegen muss sie erst noch signiert werden (hierfür wird das Tool Uber APK Signer verwendet). Anhand der Signatur kann Android auch feststellen, ob eine bereits installierte App mit der entsprechenden APK-Datei aktualisiert werden kann. Da die veränderte Spotify-App selbst signiert wird, muss eine eventuell vorhandene Original-Spotify-App zuerst deinstalliert werden.

Systemvoraussetzungen

Spotify-Gender-Ex ist mit Windows und Linux kompatibel (getestet mit Ubuntu 20 und Windows 10)

Python 3 und Java müssen auf deinem System installiert sein (testen mit python3 und java -version). Außerdem brauchst du natürlich auch ein Android-Smartphone oder Tablet, um die modifizierte App zu installieren.

Wie es geht

  1. Lade die Spotify-App als apk-Datei herunter. Hierfür empfehle ich uptodown.

  2. Öffne ein Terminal in einem leeren Ordner und erstelle eine neue Python-Umgebung mit dem Befehl python -m venv venv. Aktiviere sie mit source venv/bin/activate bzw auf Windows mit venv\Scripts\activate.

  3. Installiere Spotify-Gender-Ex mit diesem Befehl:

    pip3 install spotify-gender-ex
    
  4. Starte das Skript und gebe als Argument die APK-Datei, die du in Schritt 1 heruntergeladen hast, an. Möchtest du eine andere als die eingebaute Ersetzungstabelle verwenden? Dann gib diese mit dem -rt-Flag an

    python3 main.py spotify-x-x-xx-xxx.apk
    python3 main.py spotify-x-x-xx-xxx.apk -rt genderex/replacements.json
    
    0. INFO
    In: spotify-8-5-89-901.apk
    Out: genderex
    Ersetzungstabelle: /home/thetadev/test-genderex/venv/lib/python3.8/site-packages/spotify_gender_ex/res/replacements.json
    APKTool: /home/thetadev/test-genderex/venv/lib/python3.8/site-packages/spotify_gender_ex/lib/apktool.jar
    APKSigner: /home/thetadev/test-genderex/venv/lib/python3.8/site-packages/spotify_gender_ex/lib/uber-apk-signer-1.2.1.jar
    Starten? [y/N]: y
    
  5. Bestätige mit y + Enter. Nun wird die apk-Datei dekompiliert, es werden die Ersetzungen vorgenommen und anschließend wird eine neue, signierte apk-Datei erzeugt.

  6. Wenn du eine neue Spotify-Version verwendest, kann es sein, dass neue Einträge zur Sprachdatei und damit auch neue Gendersternchen hinzukommen. Diese werden als 'verdächtige Felder' angezeigt. Zudem kann es passieren, dass sich durch ein Update die Einträge der Sprachdatei verändern. Sollte einer dieser Einträge eigentlich verändert werden, wird dieser als 'Feld mit geändertem Original' markiert. Bei einer blinden Ersetzung könnten in diesem Fall Informationen verloren gehen.

    Nun hast du 2 Möglichkeiten. Entweder du fährst fort, dann werden die verdächtigen Felder nicht ersetzt, oder du brichst den Vorgang ab. In diesem Fall wird eine neue Ersetzungstabelle (replacements.json) im genderex-Ordner angelegt. Um diese Tabelle selbst anzupassen und zu verwenden, siehe den Abschnitt Ersetzungstabelle.

    2. DEGENDERIFIZIEREN
    0 Ersetzungen vorgenommen
    0 Felder mit geändertem Original
    3 verdächtige Felder
    Beenden und die Ersetzungstabelle zuerst manuell bearbeiten? [y/N]:
    
  7. Wenn alles geklappt hat, befindet sich nach Abschluss des Skripts eine veränderte und signierte Spotify-App unter genderex/spotify-x-x-xx-xxx-gex-aligned-signed.apk. Diese Datei kannst du nun auf dein Handy/Tablet übertragen und installieren. Hierfür einfach die APK-Datei im Dateimanager öffnen und eventuell noch die Installation aus unbekannten Quellen erlauben.

    Vorher muss die Original-Spotify-App deinstalliert werden, da eine App mit anderer Signatur nicht als Update installiert werden kann.

    Es kann passieren, dass Play Protect aufgrund der unbekannten Signatur eine Meldung ausgibt, in diesem Fall einfach auf "Trotzdem installieren" und "Nicht an Google senden" tippen.

  8. Nun kannst du die Spotify-App öffnen, dich anmelden und Musik ohne Gendersternchen genießen. Du kannst auch ins Einstellungsmenü gehen und auf Drittanbieter-Software tippen. Auf der Seite befinden sich Informationen über dieses Skript, die zum Testen und zur Fehlersuche relevant sein können.

Ersetzungstabelle

Spotify-Gender-Ex hat eine Ersetzungstabelle eingebaut, die standardmäßig verwendet wird (befindet sich unter spotify_gender_ex/res/replacements.json). Die Ersetzungstabelle enthält eine Liste kompatibler Spotify-Versionen und sämtliche vorzunehmenden Ersetzungen bestehend aus Sprachdatei, Schlüssel, Originaltext und neuem Text.

Hier ein Beispiel für eine Ersetzungsregel:

{
  "key": "artist_default_title",
  "old": "Künstler*in",
  "new": "Künstler"
}

Wenn du die Ersetzungstabelle selbst verändern möchtest, kannst du sie entweder direkt von Github kopieren oder du lässt das Skript laufen und es stellt fest, dass verdächtige Einträge in der Spotify-Sprachdatei gefunden wurden, die einer Anpassung der Ersetzungstabelle bedürfen. In diesem Fall wird automatisch eine neue Ersetzungstabelle unter genderex/replacements(_X).json erstellt, die die fehlenden Einträge vorausgefüllt beinhaltet.

Ungefähr so:

{
  "key": "your_library_sort_order_artist_name_alphabetically_in_artists", 
  "old": "Künstler*in",
  "new": "Künstler*in EDIT"
}

An die automatisch erzeugten Einträge wird das Wort EDIT angefügt, damit diese schnell zu finden sind. Das einzige, was du machen musst, ist bei allen markierten Einträgen das Feld new anzupassen. Bitte keine anderen Felder ändern, das Feld old muss so bleiben, wie es ist.

Anschließend kannst du Spotify-Gender-Ex erneut starten und hierbei die Ersetzungstabelle mit dem Flag -rt ./path/to/replacements.json übergeben.

Bei der Ersetzung geht Spotify-Gender-Ex durch die komplette Ersetzungstabelle und versucht, das entsprechende Feld anhand des Schlüssels und des alten Texts in der Sprachdatei zu finden. Wurde ein zu ersetzendes Feld gefunden, wird der Text durch den neuen ausgetauscht.

FAQ

Betrug! Da sind immer noch Gendersternchen in der App!

Die Spotify-App besteht nicht nur aus vorprogrammierten Interfaces, sondern auch aus dynamischen Inhalten, die tagesaktuell von Spotify heruntergeladen werden (im Grunde nichts anderes als an die Spotify-App angepasste Websites). Dies ist bei der Startseite sowie bei Künstler-Seiten der Fall. Da diese Texte direkt von den Spotify-Servern und nicht aus der Sprachdatei der App stammen, lassen sie sich auch nicht durch Modifikation der App verändern.

Die Installation der modifizierten App funktioniert nicht

  • Stelle sicher, dass du die App-Installation von unbekannten Quellen aktiviert hast
  • Verwende die signierte Version (spotify-x-x-xx-xxx-gex-aligned-signed.apk)
  • Stelle sicher, dass du nicht die originale oder eine mit einen anderen als dem im Verzeichnis genderex/genderex.keystore befindlichen Keystore signierte Spotify-App installiert hast.

Ich liebe Gendersternchen/nutze kein Spotify. Ist dieses Skript auch für was anderes nützlich?

Ja, man könnte dieses Skript bspw. auch dafür benutzen, um Spotify (bzw. mit Änderungen jede andere Android-App) in eine andere Sprache zu übersetzen, wenn die Originalübersetzung nicht vorhanden oder von mangelhafter Qualität ist.

Lizenzen und Rechtliches

Dieses Projekt enthält die Java-Pakete apktool (iBotPeaches) und Uber APK Signer (patrickfav), die beide unter der Apache 2.0 License stehen. Vielen Dank für diese großartigen Open-Source-Projekte! Die Lizenzen befinden sich im spotify_gender_ex/lib-Ordner.

Es ist mir aus Copyrightgründen nicht erlaubt, degenderifizierte Kopien der Spotify-App zum Download anzubieten. Wenn du dieses Tool herunterlädst und deine Spotify-App selbst modifizierst, gehst du sämtliche damit verbundene Risiken ein. Sollte die App nicht wie gewünscht funktionieren, empfehle ich, zuerst die Originalversion zu testen, bevor du dich an den Spotify-Support wendest.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Spotify-Gender-Ex-0.3.0.tar.gz (20.9 MB view hashes)

Uploaded Source

Built Distribution

Spotify_Gender_Ex-0.3.0-py3-none-any.whl (20.9 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page