--- title: "Pobierz Wszystkie Zdjęcia i Filmy" description: "Pobierz całą swoją bibliotekę PixelUnion na komputer za pomocą immich-archiver lub Immich Go" url: "https://pixelunion.eu/pl/help/immich/download-photos-videos/" weight: 5 --- Możesz pobrać całą swoją bibliotekę zdjęć i filmów z PixelUnion na własny komputer. Przydaje się to, gdy chcesz: - Zachować lokalną kopię swoich plików obok biblioteki PixelUnion - Pobrać swoje dane przed usunięciem konta - Przenieść bibliotekę do innej usługi - Mieć kopię offline swoich wspomnień Służą do tego dwa narzędzia: - **immich-archiver** jest tworzone i utrzymywane przez PixelUnion. Użyj go, aby w prosty sposób skopiować całą bibliotekę. To je polecamy. - **Immich Go** to narzędzie społecznościowe z większymi możliwościami filtrowania, na przykład pobraniem tylko wybranych albumów, tagów lub zakresu dat. Obecnie dotyczy go błąd, opisany niżej. Oba narzędzia wymagają klucza API, więc zacznij od tego. ## Krok 1: pobierz swój klucz API 1. Zaloguj się w swojej domenie PixelUnion (na przykład `https://twojanazwa.pixelunion.eu`) 2. Kliknij ikonę profilu w prawym górnym rogu 3. Wybierz **Ustawienia konta** 4. Przejdź do **Klucze API** 5. Kliknij **Nowy klucz API** 6. Nadaj mu opisową nazwę (na przykład „Narzędzie do pobierania") 7. **Skopiuj wygenerowany klucz API**, będzie potrzebny w następnym kroku ⚠️ **Ważne**: przechowuj klucz API bezpiecznie i nie udostępniaj go nikomu. W razie potrzeby możesz go później unieważnić. ## immich-archiver (zalecane) immich-archiver kopiuje każde zdjęcie i film z twojej osi czasu do folderów według daty na dysku i zapisuje obok każdego pliku plik `.json` ze wszystkimi metadanymi, jakie posiadamy: datą wykonania, aparatem, lokalizacją GPS, przynależnością do albumów, twarzami i ocenami. Na dysku wygląda to tak: ``` PixelUnion-Backup/2005/2005-06/IMG_0001.jpg PixelUnion-Backup/2005/2005-06/IMG_0001.jpg.json ``` Jeśli uruchomisz je ponownie później, pobierze tylko nowe pliki, więc aktualizacja kopii jest szybka. ### Krok 2: pobierz immich-archiver 1. Przejdź na [stronę wydań immich-archiver](https://github.com/pixelunioneu/immich-archiver/releases/latest) 2. Pobierz plik dla swojego systemu: - **Windows**: `immich-archiver_..._windows_amd64.exe` - **macOS (Apple Silicon)**: `immich-archiver_..._darwin_arm64` - **macOS (Intel)**: `immich-archiver_..._darwin_amd64` - **Linux**: `immich-archiver_..._linux_amd64` (lub `linux_arm64` na przykład na Raspberry Pi) 3. Przenieś pobrany plik do folderu, w którym chcesz mieć kopię zapasową 4. Zmień jego nazwę na `immich-archiver` (w systemie Windows `immich-archiver.exe`). Pobrana nazwa zawiera numer wersji, a zmiana nazwy sprawia, że poniższe polecenia pozostaną takie same po późniejszej aktualizacji. Wersje dla macOS są podpisane i notaryzowane u Apple, więc uruchamiają się bez ostrzeżenia bezpieczeństwa. W systemach macOS i Linux musisz jednorazowo nadać plikowi prawo wykonywania. Otwórz terminal w tym folderze i uruchom: ``` chmod +x immich-archiver ``` ### Krok 3: uruchom je Otwórz terminal w folderze zawierającym plik: - **Windows**: kliknij folder prawym przyciskiem → „Otwórz w terminalu" - **macOS**: otwórz aplikację **Terminal**, wpisz `cd ` i spację, przeciągnij folder do okna i naciśnij Enter - **Linux**: otwórz terminal i przejdź do folderu Następnie uruchom narzędzie, zastępując symbole zastępcze własnymi danymi: **Windows:** ``` .\immich-archiver.exe --url https://twojanazwa.pixelunion.eu --api-key TWOJ_KLUCZ_API --dir .\PixelUnion-Backup ``` **macOS/Linux:** ``` ./immich-archiver --url https://twojanazwa.pixelunion.eu --api-key TWOJ_KLUCZ_API --dir ./PixelUnion-Backup ``` Zastąp `twojanazwa.pixelunion.eu` własną domeną, a `TWOJ_KLUCZ_API` kluczem z kroku 1. Aby nie wpisywać klucza za każdym razem, możesz ustawić zmienne środowiskowe: `IMMICH_URL`, `IMMICH_API_KEY` i `IMMICH_DIR`. Gdy są ustawione, wystarczy uruchomić samo `immich-archiver`. ### Przydatne opcje | Opcja | Co robi | |---|---| | `--dry-run` | Pokazuje, co zostałoby pobrane, bez zapisywania czegokolwiek | | `--verbose` | Wypisuje wiersz dla każdego pliku zamiast bieżącego licznika | | `--path-template "{year}/{month}/{day}"` | Zmienia strukturę folderów. Domyślnie `{year}/{year}-{month}` | | `--include-shared` | Pobiera także albumy udostępnione ci przez inne osoby, do osobnego folderu `shared-with-me` | | `--concurrency 8` | Pobiera więcej plików naraz. Domyślnie 4 | | `--retries 5` | Częściej ponawia nieudane pobrania. Domyślnie 3 | Uruchom narzędzie z opcją `--help`, aby zobaczyć wszystko, co obsługuje. ## Immich Go (do zaawansowanego filtrowania) Immich Go to narzędzie wiersza poleceń stworzone przez społeczność. Oferuje filtry, których immich-archiver jeszcze nie ma, na przykład ograniczenie pobierania do wybranych albumów, tagów lub zakresu dat.

Znany błąd w immich-go: nieprawidłowe nazwy plików

W immich-go istnieje znany błąd wpływający na polecenie archive from-immich. Eksportowane pliki mogą otrzymywać nieprawidłowe nazwy numeryczne (takie jak -1, -2) bez rozszerzenia, a metadane albumów mogą być nieobecne w eksporcie. Trwają prace nad poprawką. Możesz śledzić postępy na GitHub (PR #1272). Zalecamy skorzystanie z opisanego wyżej immich-archiver lub poczekanie na zaktualizowaną wersję immich-go przed użyciem tego polecenia.

### Pobierz Immich Go 1. Przejdź na [stronę wydań Immich Go](https://github.com/simulot/immich-go/releases/latest) 2. Pobierz wersję dla swojego systemu operacyjnego: - **Windows**: pobierz plik `.exe` - **macOS**: pobierz plik z `darwin` w nazwie - **Linux**: pobierz plik z `linux` w nazwie 3. Rozpakuj pobrany plik `.zip` 4. Umieść plik wykonywalny `immich-go` w folderze, do którego chcesz pobrać zdjęcia ### Uruchom polecenie pobierania **Windows:** ``` ./immich-go.exe archive from-immich --from-server=https://twojanazwa.pixelunion.eu/ --from-api-key=TWOJ_KLUCZ_API --write-to-folder=./PixelUnion-Backup ``` **macOS/Linux:** ``` ./immich-go archive from-immich --from-server=https://twojanazwa.pixelunion.eu/ --from-api-key=TWOJ_KLUCZ_API --write-to-folder=./PixelUnion-Backup ``` Zastąp: - `twojanazwa.pixelunion.eu` swoją rzeczywistą domeną PixelUnion - `TWOJ_KLUCZ_API` kluczem API skopiowanym w kroku 1 - `./PixelUnion-Backup` ścieżką, w której chcesz zapisać zdjęcia **Uwaga**: flaga `--write-to-folder` jest wymagana. ### Opcje filtrowania Immich Go #### Pobierz tylko zdjęcia (pomiń filmy) ``` ./immich-go archive from-immich --from-server=https://twojanazwa.pixelunion.eu/ --from-api-key=TWOJ_KLUCZ_API --write-to-folder=./PixelUnion-Backup --from-include-type=IMAGE ``` #### Pobierz tylko filmy (pomiń zdjęcia) ``` ./immich-go archive from-immich --from-server=https://twojanazwa.pixelunion.eu/ --from-api-key=TWOJ_KLUCZ_API --write-to-folder=./PixelUnion-Backup --from-include-type=VIDEO ``` #### Pobierz tylko ulubione zdjęcia ``` ./immich-go archive from-immich --from-server=https://twojanazwa.pixelunion.eu/ --from-api-key=TWOJ_KLUCZ_API --write-to-folder=./PixelUnion-Backup --from-favorite ``` #### Pobierz zdjęcia z określonych albumów ``` ./immich-go archive from-immich --from-server=https://twojanazwa.pixelunion.eu/ --from-api-key=TWOJ_KLUCZ_API --write-to-folder=./PixelUnion-Backup --from-albums="Nazwa albumu 1" --from-albums="Nazwa albumu 2" ``` #### Pobierz zdjęcia z określonymi tagami ``` ./immich-go archive from-immich --from-server=https://twojanazwa.pixelunion.eu/ --from-api-key=TWOJ_KLUCZ_API --write-to-folder=./PixelUnion-Backup --from-tags="tag1" --from-tags="tag2" ``` #### Pobierz zdjęcia z zakresu dat ``` ./immich-go archive from-immich --from-server=https://twojanazwa.pixelunion.eu/ --from-api-key=TWOJ_KLUCZ_API --write-to-folder=./PixelUnion-Backup --from-date-range="2024-01-01:2024-12-31" ``` ## Rozwiązywanie problemów ### Problemy z połączeniem - Upewnij się, że twoja domena PixelUnion jest poprawna i zawiera `https://` - Sprawdź, czy klucz API jest poprawny i nie został unieważniony - Sprawdź połączenie internetowe ### „Permission denied" w systemie macOS lub Linux - Najpierw musisz nadać plikowi prawo wykonywania: `chmod +x immich-archiver` ### Przerwane pobieranie - Oba narzędzia kontynuują od miejsca, w którym przerwały, jeśli ponownie uruchomisz polecenie - Pliki już pobrane nie są pobierane po raz drugi ### Duże biblioteki - W przypadku bardzo dużych bibliotek (tysiące plików) pobieranie może potrwać kilka godzin - Upewnij się, że komputer nie przejdzie w stan uśpienia podczas pobierania - Rozważ uruchomienie pobierania na noc ## Po pobraniu Gdy pobieranie się zakończy: - Twoje zdjęcia i filmy znajdują się we wskazanym folderze - Pliki zachowują oryginalne nazwy i daty - Możesz wykonać kopię tych plików w innym miejscu lub je przenieść Warto sprawdzić swoją kopię, zanim zaczniesz na niej polegać. Otwórz folder i upewnij się, że kilka zdjęć rzeczywiście się otwiera. ## Potrzebujesz pomocy? Jeśli napotkasz problemy: - W przypadku immich-archiver zobacz [stronę projektu na GitHubie](https://github.com/pixelunioneu/immich-archiver) - W przypadku Immich Go zobacz [dokumentację Immich Go](https://github.com/simulot/immich-go) - [Skontaktuj się z naszym zespołem wsparcia](/support/), aby uzyskać pomoc