Na tej stronie6 sekcji ▾
CLI Free Your Music przenosi aplikację webową Free Your Music do twojego terminala. Korzysta z twojego konta Free Your Music, więc widzi te same połączone serwisy, transfery i playlisty co aplikacja webowa. CLI jest częścią Pro.
Czego potrzebujesz
- Node.js 20 lub nowszy z npm, na macOS, Windows lub Linux.
- Konto Free Your Music z Pro: to samo, którego używasz na freeyourmusic.com/app.
Instalacja i logowanie
Zainstaluj CLI Free Your Music i zaloguj się
- W terminalu uruchom npm i -g @freeyourmusic/cli.
- Uruchom fym login. Przeglądarka otworzy freeyourmusic.com/app/cli, a terminal pokaże krótki kod.
- Zaloguj się przez e-mail, Apple lub Google. Sprawdź, czy kod w przeglądarce zgadza się z kodem w terminalu, i dotknij Zezwól. Bez Pro strona najpierw zaproponuje Pro.
- Uruchom fym services connect spotify (lub inny serwis) i zaloguj się do tego serwisu w przeglądarce.
- Uruchom fym library playlists, aby zobaczyć swoje playlisty.
Na komputerze bez przeglądarki uruchom fym login --no-browser i otwórz link na telefonie. Sesja trwa, dopóki z niej korzystasz: CLI odnawia ją samo. fym logout wylogowuje ten komputer.
Co mogę z nim zrobić?
| Grupa | Co robi |
|---|---|
| status, services, accounts | Stan logowania, łączenie i ponowne łączenie serwisów muzycznych, lista kont |
| library, search | Odczyt playlist, polubionych utworów, albumów i wykonawców; wyszukiwanie w serwisie |
| transfers | Rozpoczynanie, śledzenie, wstrzymywanie, wznawianie, ponawianie i usuwanie transferów; automatyczna synchronizacja |
| playlists, covers | Tworzenie, edycja, sortowanie, mieszanie, usuwanie duplikatów, dzielenie, łączenie, kopiowanie, przywracanie wersji, okładki |
| matches | Przegląd niedopasowanych utworów i wybór zamiennika |
| insights, stats, exports | Statystyki playlist, statystyki słuchania, eksport biblioteki |
| account, premium, notifications | Twoje konto, plany Pro i płatność, klucze licencji, ustawienia e-maili |
Uruchom fym help, aby zobaczyć wszystkie polecenia, i dodaj --help do polecenia, aby zobaczyć jego flagi. Dodaj --json do dowolnego polecenia, aby dostać wynik czytelny dla skryptów. Polecenia, które usuwają lub zastępują dane, wymagają --yes. Nie ma polecenia anulowania transferu: wstrzymaj lub usuń transfer.
Kody wyjścia
| Kod | Znaczenie | Co zrobić |
|---|---|---|
| 0 | Sukces | Nic. |
| 1 | Błędne dane wejściowe albo serwer je odrzucił | Sprawdź polecenie z --help. |
| 2 | Nie jesteś zalogowany albo sesja się skończyła | Uruchom fym login. |
| 3 | Nie udało się połączyć z Free Your Music | Sprawdź połączenie i spróbuj ponownie. |
| 4 | Polecenie wymaga Pro | Uruchom fym premium plans i wykup Pro. |
| 5 | Zbyt wiele żądań | Odczekaj chwilę i spróbuj ponownie. |
Jak to działa i co pozostaje prywatne
CLI łączy się z API Free Your Music przez HTTPS, tak jak aplikacja webowa. Po dotknięciu Zezwól przechowuje sesję w pliku ~/.fym/credentials.json, który może odczytać tylko twoje konto użytkownika. Twoje logowania do serwisów muzycznych zostają na serwerach Free Your Music; CLI nigdy nie widzi twoich haseł.
W skryptach i CI ustaw FYM_TOKEN zamiast logowania. fym account sign-out-everywhere kończy wszystkie inne sesje twojego konta: w przeglądarce, w aplikacjach i w innych CLI.
CLI nie dodaje żadnego śledzenia. Opublikowane wersje zgłaszają nieoczekiwane błędy do naszego narzędzia raportowania awarii, bez argumentów poleceń i danych logowania. Ustaw FYM_DISABLE_TELEMETRY=1, aby to wyłączyć.
Najczęściej zadawane pytania
Czy CLI jest darmowe?
Nie. CLI i serwer MCP są częścią Pro. Transfery są darmowe w aplikacji webowej oraz w aplikacjach na iPhone i Android.
Jak przejść na Pro z poziomu CLI?
Uruchom fym premium plans, aby zobaczyć plany, a potem fym premium buy z wybranym planem. Dostaniesz link do płatności, który otworzysz w przeglądarce.
Czego użyć: CLI czy serwera MCP?
Używaj CLI do skryptów, zadań cron i CI. Używaj serwera MCP, gdy chcesz poprosić asystenta AI na czacie o pracę z twoją muzyką. Oba korzystają z jednego logowania na twoim komputerze.
Potrzebujesz pomocy z CLI? Skontaktuj się z pomocą techniczną i wklej wynik polecenia fym status.