first commit

README.md

@@ -0,0 +1,160 @@
+# Sincronizzazione Google Photos → Immich (TypeScript)
+
+Questo progetto permette di sincronizzare automaticamente gli album condivisi di Google Photos con il tuo server Immich locale, scritto in TypeScript per una migliore manutenibilità e type safety.
+
+## Caratteristiche
+
+- Sincronizza foto da album specifici di Google Photos verso Immich
+- Forte tipizzazione con TypeScript per evitare errori comuni
+- Memorizza le foto già sincronizzate per evitare duplicati
+- Crea automaticamente gli album in Immich se non esistono
+- Supporta l'aggiornamento del token di autenticazione Google
+
+## Prerequisiti
+
+- Node.js (v14 o superiore)
+- TypeScript installato globalmente o localmente
+- Un server Immich funzionante
+- Un account Google con accesso agli album condivisi
+- Credenziali OAuth2 di Google Cloud Platform
+
+## Installazione
+
+1. Clona o scarica questo repository
+2. Installa le dipendenze:
+
+```bash
+npm install
+```
+
+## Configurazione
+
+### 1. Ottenere le credenziali OAuth2 di Google
+
+1. Vai alla [Console Google Cloud](https://console.cloud.google.com/)
+2. Crea un nuovo progetto o seleziona uno esistente
+3. Vai a "API e servizi" > "Credenziali"
+4. Clicca su "Crea credenziali" e seleziona "ID client OAuth"
+5. Configura l'applicazione come "App web"
+6. Aggiungi `http://localhost:3000/oauth2callback` come URI di reindirizzamento
+7. Salva il Client ID e il Client Secret
+
+### 2. Abilitare l'API di Google Photos
+
+1. Nella Console Google Cloud, vai a "API e servizi" > "Libreria"
+2. Cerca "Photos Library API" e abilitala
+
+### 3. Ottenere l'API key di Immich
+
+1. Accedi alla tua interfaccia web di Immich
+2. Vai alle impostazioni del profilo
+3. Nella sezione "API Keys", genera una nuova chiave
+
+### 4. Configurare lo script
+
+Modifica il file `google-photos-to-immich-sync.ts` e aggiorna la sezione `CONFIG`:
+
+```typescript
+const CONFIG: Config = {
+  // Configurazione Google Photos
+  googlePhotos: {
+    clientId: 'TUO_CLIENT_ID', // Inserisci il tuo Client ID
+    clientSecret: 'TUO_CLIENT_SECRET', // Inserisci il tuo Client Secret
+    redirectUri: 'http://localhost:3000/oauth2callback',
+    scopes: ['https://www.googleapis.com/auth/photoslibrary.readonly'],
+    tokenPath: path.join(__dirname, 'google_token.json'),
+    // IDs degli album da sincronizzare
+    albumIds: [
+      'ID_ALBUM_1', // Puoi trovare questi ID nell'URL quando apri un album su Google Photos
+      'ID_ALBUM_2'
+    ]
+  },
+  // Configurazione Immich
+  immich: {
+    apiKey: 'TUA_API_KEY_IMMICH', // Inserisci la tua API key di Immich
+    serverUrl: 'http://localhost:3001/api', // Modifica con l'URL del tuo server Immich
+    albumNames: {
+      'ID_ALBUM_1': 'Nome Album 1 in Immich',
+      'ID_ALBUM_2': 'Nome Album 2 in Immich'
+    }
+  },
+  tempDir: path.join(__dirname, 'temp'),
+  syncedPhotosFile: path.join(__dirname, 'synced_photos.json')
+};
+```
+
+## Come trovare gli ID degli album di Google Photos
+
+1. Apri Google Photos nel browser
+2. Vai all'album di cui desideri l'ID
+3. L'URL avrà un formato simile a: `https://photos.google.com/album/ABC123XYZ`
+4. L'ID dell'album è la parte dopo `/album/` (in questo esempio, `ABC123XYZ`)
+
+## Utilizzo
+
+### Compilazione del codice TypeScript
+
+Prima di eseguire lo script, compila il codice TypeScript:
+
+```bash
+npm run build
+```
+
+### Esecuzione
+
+Per eseguire lo script compilato:
+
+```bash
+npm start
+```
+
+Oppure, per sviluppo e test, puoi eseguirlo direttamente con ts-node:
+
+```bash
+npm run dev
+```
+
+### Prima esecuzione
+
+La prima volta che esegui lo script, ti verrà chiesto di autorizzare l'accesso a Google Photos:
+
+1. Ti verrà mostrato un URL da visitare
+2. Accedi con il tuo account Google e autorizza l'applicazione
+3. Copia il codice fornito e incollalo nella console
+4. Lo script inizierà la sincronizzazione
+
+### Esecuzioni successive
+
+Nelle esecuzioni successive, lo script utilizzerà il token salvato in `google_token.json` e sincronizzerà solo le nuove foto.
+
+## Automatizzazione
+
+Per automatizzare la sincronizzazione, puoi configurare un cron job:
+
+```bash
+# Esempio: esegui la sincronizzazione ogni giorno alle 3:00
+0 3 * * * cd /percorso/al/progetto && npm start >> sync.log 2>&1
+```
+
+## Estensione del codice
+
+Il codice TypeScript è strutturato con interfacce ben definite, rendendo facile l'estensione per aggiungere nuove funzionalità. Puoi facilmente:
+
+- Aggiungere supporto per filtri basati su metadata delle foto
+- Implementare la sincronizzazione bidirectionale
+- Creare una versione con interfaccia grafica
+
+## Risoluzione dei problemi
+
+- **Errore di compilazione TypeScript**: Verifica che tutte le dipendenze siano installate con `npm install` e che TypeScript sia installato
+- **Errore di autenticazione**: Elimina il file `google_token.json` e riavvia lo script
+- **Errore nel caricamento delle foto**: Verifica che l'API key di Immich sia corretta e che il server sia raggiungibile
+- **Errore nel recupero delle foto da Google**: Verifica che gli ID degli album siano corretti
+
+## Contributi
+
+Contributi e miglioramenti sono benvenuti! Sentiti libero di inviare pull request o segnalare problemi.
+
+## Licenza
+
+MIT