Pobierz Wszystkie Zdjęcia i Filmy

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
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

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.

Pobierz Immich Go

1. Przejdź na stronę wydań Immich Go
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
• W przypadku Immich Go zobacz dokumentację Immich Go
• Skontaktuj się z naszym zespołem wsparcia, aby uzyskać pomoc