Home Linux Project
Manny
     
Video Preview

Tweet

English:
What is it?
Manny is a Google Music manager for Linux.
With this program you'll can view all the songs existing in your Google Music Account, play them with your favorite player (for now only VLC and Mplayer are supported!) or download (yes, download!) them on your PC.
And all this without even opening your web browser!


Disclaimer
This program is amateur and especially is not in any way related to Google.
The program allows you to download only the songs you have on your account (so songs previously in possession) and for this reason should not break any laws.
The login data are stored on your computer only if specified by the user (by selecting the "Remember login data" in the login screen!). For this reason, if that option is not selected, no data will be saved on your pc and can be used without problems on any public computer.
I take no responsability about any possible damage that this program may cause to your Google Music account or to your songs.
Obviously the program has been tested but the presence of bugs can not be ruled out. If you find any bug please report it to me and I'll try to resolve it as soon as possible.


Features
v1.9.3-2
-Now the program uses only the https protocol (the old simple http protocol is deprecated)

v.1.9.3
-Fixed a bug that did not allow to download and play songs to those accounts which wanted the "?u=0" params into the url.

v1.9.2
-Fixed again (yes, again xD) the login function that did not work for some accounts which wanted the "?u=0" params into the login url.
-Added debug messages if any error occurred during login process. These messages will show the server response, in this way will be easier to understand the cause of the error.
-Added the possibility to report the debug messages directly to me via email.

v1.9.1
-Fixed again the login function that did not work anymore after the transition from Google Music to Google Play.

v1.9
-Fixed the login function that did not work anymore with the new https protocol used by Google Music.
-Preliminary functions to support Playlists (this feature will be available starting from v2.0 final)
-Preliminary functions to create an Internal Player (this feature will be available starting from v2.0 final)

v1.0
-Ability to load and view ALL the songs in your Google Music account.
-Ability to view your songs organized in Albums, Artists, or Genre.
-Ability to play a song using VLC or MPlayer
-Ability to save into a TXT the list of albums you have on your Account
-Ability to save into a TXT the list of genres present in your Account
-Ability to save into a TXT the list of artists present in your Account
-Ability to save the list of ALL songs (or even a part of them) present in your account into a TXT, CSV or XML.
-Ability to download onto your PC one or more songs from your account!


Dependencies and Installation
UPDATE: now if you are under Archlinux then you can install Manny from AUR simply typing in a terminal:
yaourt -S manny
Otherwise continue to read...

The program is written in Gambas3 and requires some dependencies to work.
Specifically requires:
( gambas3-runtime gambas3-gb-desktop gambas3-gb-form gambas3-gb-gui gambas3-gb-image gambas3-gb-settings gambas3-gb-web ) <- from the package Gambas3, these dependencies are mandatory
( curl ) <- Required dependencies! Curl is used to connect with your Google Music account.
( mplayer vlc ) <- These dependencies are optional but you need them to play your songs. You can also choose only 1 of the two. Obviously in this case then the other will not work.
( wget ) <- This dependency is optional but you need it if you want to download your songs.

On Arch Linux (the distro I use) just type in a terminal:
sudo pacman -S gambas3-runtime gambas3-gb-desktop gambas3-gb-form gambas3-gb-gui gambas3-gb-image gambas3-gb-settings gambas3-gb-web mplayer vlc wget curl

On Ubuntu (and derivatives) to install Gambas3 packages you have to add a repository. From the terminal type in sequence:
sudo add-apt-repository ppa:ihaywood3/gambas3
sudo apt-get update
sudo apt-get install gambas3-runtime gambas3-gb-desktop gambas3-gb-form gambas3-gb-gui gambas3-gb-image gambas3-gb-settings gambas3-gb-web mplayer vlc wget curl

Once all the necessary dependencies have been installed, give execute permissions to the file .gambas typing in a terminal:
chmod +x Manny.gambas

Now just double click on the file .gambas to start the program. Alternatively you can run it from a terminal by typing:
./Manny.gambas


Known bugs
-You can not play multiple songs: I'm working on implementing an internal player and a management system of playlists. So this bug should be fixed in future versions.
-You can not stop a batch download process: to remedy this problem you can kill the program or kill the various download process manually by pressing Ctrl+C when appears the terminal window running wget. In the future I plan to insert an internal function to download songs in order to solve this bug too.
-Sometime even if the login data are correct you got an "invalid token" error: to solve this problem just wait some minute and try again.


Thanks
-To Google for the excellent service offered by Google Music
-To Gambas authors
-To my girlfriend for her infinite patience
Italiano:
Cos'é?
Manny è un manager di Google Music per Linux.
Con questo programma potrete visualizzare tutte le canzoni presenti sul vostro account di Google Music, riprodurle con il vostro player preferito (per adesso solo VLC e Mplayer sono supportati!) oppure scaricarle (si, scaricarle!) sul vostro PC.
E il tutto senza nemmeno aprire il browser internet!


Disclaimer
Questo programma è amatoriale e soprattutto non legato in alcun modo a Google.
Il programma permette di scaricare soltanto le canzoni presenti nel VOSTRO account (ossia canzoni già precedentemente in possesso) e per tale ragione non dovrebbe infrangere alcuna legge.
I dati di login vengono salvati sul computer in uso soltanto se specificato dall'utente (selezionando l'opzione "Ricorda dati di login" nella schermata di login!). Per tale ragione, qualora non venga selezionata tale opzione, nessun dato viene salvato sul computer in uso e quindi può essere utilizzato senza problemi su qualsiasi computer pubblico.
Non mi assumo alcuna responsabilità di eventuali e remoti danni che tale programma possa arrecare al vostro account Google Music o ai vostri brani.
Ovviamente il programma è stato testato ma la presenza di eventuali bug non può essere esclusa. Se ne trovate qualcuno segnalatemelo e cercherò di risolvere il più presto possibile.


Caratteristiche
v1.9.3-2
-Ora il programma utilizza soltanto il protoccolo https (infatti il vecchio semplice http è deprecato ormai)

v.1.9.3
-Fixato un bug che non permette di scaricare o riprodurre brani a quegli account che volevano il parametro "?u=0" nell'indirizzo url.

v1.9.2
-Fixata di nuovo (si, di nuovo xD) la funzione di login che non funzionava per alcuni account che volevano il parametro "?u=0" nell'indirizzo url per il login.
-Aggiunti messaggi di debug in caso di errore al login che mostrano le risposte date dal server in modo da comprendere più facilmente la causa dell'errore.
-Aggiunta possibilità di inviare questi messaggi di debug direttamente al sottoscritto via email.

v1.9.1
-Fixata di nuovo la funzione di login che non funzionava più dopo il passaggio da Google Music a Google Play.

v1.9
-Fixata la funzione di login che non funzionava più con il nuovo protocollo https usato da Google Music.
-Funzioni preliminari per supportare le Playlists (questa funzione sarà disponibile a partire dalla v2.0 final)
-Funzioni preliminari per creare un Player interno (questa funzione sarà disponibile a partire dalla v2.0 final)

v1.0
-Possibilità di caricare e visualizzare TUTTE le canzoni presenti nel vostro Account di Google Music
-Possibilità di visualizzare i brani organizzati per Albums, Artisti o Genere.
-Possibilità di riprodurre un brano utilizzando VLC o Mplayer
-Possibilità di salvare l'elenco degli album presenti nel vostro Account in un TXT
-Possibilità di salvare l'elenco dei generi presenti nel vostro Account in un TXT
-Possibilità di salvare l'elenco degli artisti presenti nel vostro Account in un TXT
-Possibilità di salvare l'elenco di TUTTE (o anche un parte delle) canzoni presenti nel vostro Account in TXT, CSV o XML.
-Possibilità di scaricare sul vostro PC uno o più brani dal vostro Account!


Dipendenze e installazione
UPDATE: se usate Archlinux potete da oggi installare Manny da AUR semplicemente digitando in un terminale
yaourt -S manny
Altrimenti continuate a leggere...

Il programma è scritto in Gambas3 e richiede alcune dipendenze per poter funzionare.
Nello specifico necessita di:
( gambas3-runtime gambas3-gb-desktop gambas3-gb-form gambas3-gb-gui gambas3-gb-image gambas3-gb-settings gambas3-gb-web ) <- dal pacchetto di Gambas3 <- Sono dipendenze obbligatorie
( curl ) <- Dipendenza obbligatoria! Serve per effettuare il collegamento col vostro account Google Music.
( mplayer vlc ) <- Sono dipendenze facoltative ma necessarie per poter riprodurre i brani. Potete scegliere anche solo 1 dei due. Ovviamente in tal caso l'altro poi non funzionerà.
( wget ) <- Dipendenza facoltativa ma necessaria nel caso vogliate scaricare i vostri brani.

Su Archlinux (la distro che uso io) l'installazione è banale, basta dare da terminale:
sudo pacman -S gambas3-runtime gambas3-gb-desktop gambas3-gb-form gambas3-gb-gui gambas3-gb-image gambas3-gb-settings gambas3-gb-web mplayer vlc wget curl

Su Ubuntu (e derivati) invece per installare i pacchetti Gambas3 dovete prima aggiungere un repository. Da terminale digitate in sequenza:
sudo add-apt-repository ppa:ihaywood3/gambas3
sudo apt-get update
sudo apt-get install gambas3-runtime gambas3-gb-desktop gambas3-gb-form gambas3-gb-gui gambas3-gb-image gambas3-gb-settings gambas3-gb-web mplayer vlc wget curl

Una volta installate tutte le dipendenze necessarie date i permessi di esecuzione al file .gambas dando da terminale:
chmod +x Manny.gambas

Adesso basta fare un doppio click sul file .gambas per avviare il programma. In alternativa potete sempre avviarlo da terminale digitando:
./Manny.gambas


Bug noti
-Non è possibile riprodurre più brani: sto lavorando all'implementazione di un player interno e di un sistema di gestione delle playlist. Quindi il bug dovrebbe essere risolto nelle prossime versioni.
-Non è possibile interrompere un processo di download in batch: per ovviare a tale problema potete killare il programma oppure killare i vari download manualmente premendo CTRL+C quando appare la finestra di terminale con wget in esecuzione. In futuro ho intenzione di inserire un funzione interna per il download in modo da ovviare anche a tale bug.
-Ogni tanto anche se i dati di login sono corretti si ottiene un errore di "invalid token": per ovviare a questo problema basta aspettare qualche minuto e riprovare.


Ringraziamenti
-A Google per l'ottimo servizio offerto da Google Music
-Agli autori di Gambas
-Alla mia ragazza per la sua infinita pazienza
Downloads

AUR

v1.9.3-2 (binaries)

v1.9.3 (binaries)

v1.9.2 (binaries)

v1.9.1 (binaries)

v1.9 (binaries)

v1.0 (binaries)