obsidian-vault/005-Learn/Obsidian WorkingCopy Manual.md

# Obsidian + Working Copy + Gitea + Tailscale (Manual y Gratis)

## Objetivo

Tener tus notas de Obsidian sincronizadas entre:

- Laptop
- NAS con Gitea
- iPhone/iPad

Usando:

- Obsidian
- Working Copy
- Git
- Tailscale

Sin pagar Obsidian Sync. Porque ya tienes infraestructura propia y sería raro ignorarla después de montar NAS, VPN y Git solo para terminar pagando otra nube. La humanidad insiste en convertir cualquier problema resuelto en una suscripción mensual.

---

# Arquitectura Final

```text
Laptop Obsidian
   ↓ git push
Gitea en NAS
   ↓ Tailscale
iPhone Working Copy
   ↓
Obsidian Mobile
```

---

# Requisitos

## En Laptop

Instalar:

- Obsidian
- Git
- Acceso a Gitea
- Tailscale

## En iPhone/iPad

Instalar:

- Obsidian Mobile
- Working Copy
- Tailscale

---

# PARTE 1 - Crear y subir el Vault desde la laptop

## 1. Crear Vault en Obsidian

Ejemplo:

```text
obsidian-vault
```

---

## 2. Inicializar Git

Abrir terminal:

```bash
cd /ruta/de/obsidian-vault

git init
```

---

## 3. Crear .gitignore

Crear archivo:

```bash
touch .gitignore
```

Contenido recomendado:

```gitignore
.obsidian/workspace.json
.obsidian/cache/
.trash/
.DS_Store
```

Esto evita conflictos innecesarios entre dispositivos.

---

## 4. Primer commit

```bash
git add .
git commit -m "Primer commit vault obsidian"
```

---

## 5. Crear repositorio en Gitea

En Gitea:

- Crear repositorio vacío
- Nombre ejemplo:

```text
obsidian-vault
```

NO marcar:
- README
- .gitignore
- License

Porque ya existe localmente.

---

## 6. Conectar repo local con Gitea

Ejemplo:

```bash
git remote add origin http://IP-TAILSCALE:3000/usuario/obsidian-vault.git
```

---

## 7. Subir archivos

```bash
git branch -M main
git push -u origin main
```

Listo.

Tu vault ya está en el NAS.

---

# PARTE 2 - Configurar iPhone / iPad

---

## 1. Conectarse a Tailscale

Abrir Tailscale en el teléfono.

Verificar:
- conectado
- acceso al NAS

---

## 2. Clonar repositorio en Working Copy

Abrir Working Copy.

Seleccionar:

```text
+
Clone Repository
```

Usar URL de Gitea:

```text
http://IP-TAILSCALE:3000/usuario/obsidian-vault.git
```

Esperar descarga.

---

## 3. Verificar archivos

Dentro de Working Copy deben aparecer:

```text
.md
.obsidian
carpetas
```

Si no aparecen:

```text
Pull
```

---

# PARTE 3 - Copiar Vault a Archivos de iPhone

IMPORTANTE:

La versión gratuita de Working Copy NO permite sincronización automática usando “External Directory”.

Por eso utilizaremos método manual.

Sí, manual. Git confía poco en los humanos y honestamente tiene razones válidas.

---

## 1. Abrir menú compartir

Dentro del repositorio en Working Copy:

- tocar carpeta principal
- botón compartir

---

## 2. Elegir “Guardar en Archivos”

Seleccionar:

```text
Guardar en Archivos
```

NO usar:
- Process in Working Copy

---

## 3. Elegir ubicación

Seleccionar:

```text
En mi iPhone
```

Crear carpeta:

```text
ObsidianVault
```

Guardar ahí.

La estructura quedará:

```text
En mi iPhone/
└── ObsidianVault/
    ├── notas.md
    ├── proyectos/
    └── .obsidian/
```

---

# PARTE 4 - Abrir Vault en Obsidian Mobile

---

## 1. Abrir Obsidian Mobile

Seleccionar:

```text
Open folder as vault
```

---

## 2. Buscar carpeta

Ir a:

```text
En mi iPhone/ObsidianVault
```

Seleccionar carpeta.

Listo.

Tus notas ya aparecen en el teléfono.

---

# PARTE 5 - Flujo Correcto de Trabajo

---

# Laptop → iPhone

## En Laptop

```bash
git add .
git commit -m "actualizacion notas"
git push
```

---

## En iPhone

### Paso 1

Abrir Working Copy:

```text
Pull
```

### Paso 2

Volver a:

```text
Guardar en Archivos
```

Sobrescribir carpeta:

```text
ObsidianVault
```

### Paso 3

Abrir Obsidian Mobile.

Tus cambios aparecerán.

---

# iPhone → Laptop

---

## En iPhone

Editar notas en Obsidian.

---

## Luego abrir Working Copy

Revisar cambios:

```text
Changes
```

---

## Commit

```text
Commit
```

Mensaje ejemplo:

```text
notas iphone
```

---

## Push

```text
Push
```

---

## En Laptop

```bash
git pull
```

Tus cambios aparecerán.

---

# Recomendaciones IMPORTANTES

---

## 1. Usar laptop como entorno principal

La laptop debe ser:

- edición pesada
- organización
- plugins
- estructura

El teléfono debería usarse para:

- lectura
- notas rápidas
- consulta
- pequeños cambios

Eso reduce conflictos Git.

---

## 2. Evitar editar mismo archivo simultáneamente

NO hacer:

- editar en laptop
- editar mismo archivo en iPhone
- olvidar hacer pull
- luego push desde ambos lados

Eso crea conflictos.

Y Git responde exactamente como un bibliotecario cansado obligado a arbitrar peleas familiares.

---

## 3. Hacer Pull antes de editar

Regla de oro:

```text
ANTES DE EDITAR → PULL
DESPUÉS DE EDITAR → COMMIT + PUSH
```

---

# Flujo recomendado diario

## Laptop

```bash
git pull
trabajar
git add .
git commit -m "trabajo"
git push
```

---

## iPhone

```text
Pull
Editar
Commit
Push
```

---

# Resultado Final

Tendrás:

- Vault sincronizado
- Historial de cambios
- Backup en NAS
- Acceso remoto por Tailscale
- Control total de tus notas
- Independencia de servicios cloud externos

Y además aprenderás Git de forma real. Lo cual eventualmente lleva a dos caminos:
- convertirte en alguien extremadamente organizado
- o discutir con conflictos merge a medianoche mirando archivos Markdown como si fueran textos sagrados antiguos