alterclip

🧠 Alterclip

Alterclip es una herramienta en segundo plano que monitoriza tu portapapeles y modifica automáticamente los enlaces que copias, para hacerlos más seguros o aptos para compartir en plataformas como Telegram. Además, en modo streaming, abre directamente vídeos de YouTube o contenido de Instagram con tu reproductor multimedia favorito.

✨ Características

• 🔁 Reemplaza dominios por versiones alternativas (más compartibles).
• 📋 Monitoriza el portapapeles de forma continua.
• 🎬 Abre automáticamente vídeos de YouTube, Instagram y Facebook con tu reproductor multimedia favorito.
• 📚 Almacena el historial de vídeos reproducidos con título y plataforma.
• 📦 Compatible con Linux, macOS y Windows (con pequeñas adaptaciones).
• 🔧 Dos modos de funcionamiento con cambio dinámico mediante señales.
• 📊 Interfaz de línea de comandos para gestionar el historial y reproducir vídeos guardados.
• 🔍 Búsqueda avanzada en el historial con soporte para acentos y mayúsculas/minúsculas.
• 📋 Copia de URLs al portapapeles con prefijo share.only/ para compartir fácilmente.
• 🗑️ Eliminación de entradas del historial.
• 🔄 Soporte para índices relativos al reproducir vídeos (ejemplo: -1 = último, -2 = penúltimo).
• 🏷️ Sistema de tags jerárquicos para organizar el historial.
• 📊 Búsqueda por tags y sus relaciones (padres e hijos).
• 📈 Visualización de jerarquía completa de tags.

🔧 Requisitos

• Python 3.6 o superior

• Paquetes Python:

  pip install pyperclip platformdirs plyer
  

• Reproductor multimedia como mpv, vlc, etc. (por defecto usa mpv).

• Linux (uso de señales POSIX como SIGUSR1/SIGUSR2; no compatible con Windows para eso).

• Para usar la API de YouTube (opcional pero recomendado para mejor precisión):

  • Crea un proyecto en Google Cloud Platform
  • Obtén una API key de YouTube Data API v3
  • Configura la variable de entorno YOUTUBE_API_KEY con tu clave

🚀 Uso

Ejecutar el daemon

• Ejecuta el daemon principal:

  python3 alterclip.py
  

• Copia una URL al portapapeles. Si es una de las compatibles, se transformará automáticamente y reemplazará el contenido del portapapeles.

• En modo streaming, si copias un enlace de YouTube, Instagram o Facebook, se abrirá automáticamente con tu reproductor.

Usar la interfaz de línea de comandos

El CLI (alterclip-cli.py) te permite:

• Ver el historial de vídeos reproducidos con búsqueda avanzada
• Reproducir cualquier vídeo guardado usando índices absolutos o relativos
• Copiar URLs al portapapeles con prefijo share.only/ para compartir
• Eliminar entradas del historial
• Cambiar el modo de funcionamiento
• Gestionar tags jerárquicos para organizar el historial

Ejemplos de uso:

# Ver historial completo
./alterclip-cli hist

# Ver solo las últimas 5 entradas
./alterclip-cli hist --limit 5

# Buscar vídeos en el historial que contengan "música"
./alterclip-cli search música

# Reproducir el último vídeo guardado
./alterclip-cli play -1

# Copiar la URL del penúltimo vídeo al portapapeles
./alterclip-cli copy -2

# Eliminar el vídeo con ID 123
./alterclip-cli rm 123

# Cambiar el modo de alterclip
./alterclip-cli toggle

# Añadir un nuevo tag
./alterclip-cli tag add "Arqueología" --description "Contenido relacionado con arqueología"

# Crear un tag hijo
./alterclip-cli tag add "Antiguas Civilizaciones" --parent "Arqueología"

# Asociar un tag con una URL
./alterclip-cli tag url 123 "Arqueología"

# Ver la jerarquía completa de tags
./alterclip-cli tag hierarchy

# Buscar URLs con un tag específico
./alterclip-cli hist --tags "Arqueología"

# Actualizar un tag
./alterclip-cli tag update "Arqueología" --new-name "Arqueología y Antigüedad"

# Eliminar un tag
./alterclip-cli tag rm "Arqueología"

# Ver ayuda completa
./alterclip-cli man

🔁 Modos de funcionamiento

Alterclip tiene dos modos:

• 🟢 Modo Streaming (por defecto):
  Reproduce enlaces compatibles como YouTube, Instagram o Facebook.

• 🔴 Modo Offline:
  Solo reescribe URLs y las guarda en el historial para futura referencia.

Puedes cambiar entre modos de dos formas:

• Usando señales (solo en sistemas POSIX):

  kill -USR1 <pid>  # Activa modo streaming
  kill -USR2 <pid>  # Activa modo offline
  

• Usando el CLI:

  ./alterclip-cli toggle
  

El PID aparece al inicio en los logs, o puedes obtenerlo con:

ps aux | grep alterclip

📄 Dominios reescritos

Algunos ejemplos de reemplazos automáticos de enlaces:

Original	Reemplazo
x.com	fixupx.com
tiktok.com	tfxktok.com
twitter.com	fixupx.com
fixupx.com	twixtter.com
reddit.com	reddxt.com
onlyfans.com	0nlyfans.net
patreon.com	pxtreon.com
pornhub.com	pxrnhub.com
nhentai.net	nhentaix.net
discord.gg	disxcord.gg
discord.com	discxrd.com
mediafire.com	mediaf1re.com

📚 Historial de vídeos

Alterclip guarda automáticamente todas las URLs de streaming en su base de datos, incluso cuando está en modo offline. Para cada vídeo se almacena:

• URL original
• Título del contenido (cuando está disponible)
• Plataforma (YouTube, Instagram, Facebook)
• Fecha y hora de reproducción

Puedes acceder al historial usando el CLI:

🗂️ Logs y Base de datos

Logs

Los logs se guardan en:

~/.local/state/alterclip/alterclip.log

Contienen información útil como el PID, cambios de modo, errores de reproducción y actividad reciente.

Base de datos

La base de datos de historial se almacena en:

~/.local/state/alterclip/streaming_history.db

🧪 Ejecución como servicio

Puedes usar nohup, systemd, tmux o screen para mantener Alterclip ejecutándose en segundo plano:

nohup python3 alterclip.py &

También puedes crear un servicio systemd como este (guarda como ~/.config/systemd/user/alterclip.service):

[Unit]
Description=Alterclip Clipboard Monitor
After=network.target

[Service]
ExecStart=/usr/bin/python3 /ruta/a/alterclip.py
Restart=always

[Install]
WantedBy=default.target

Y luego habilítalo con:

systemctl --user daemon-reexec
systemctl --user daemon-reload
systemctl --user enable --now alterclip.service

🟢 Ejecutar Alterclip con gtk-launch

Para lanzar Alterclip utilizando gtk-launch, es necesario tener un archivo .desktop correctamente configurado en tu sistema. Este método es útil si quieres integrar Alterclip con entornos gráficos o lanzadores de aplicaciones.

1. Crear el archivo .desktop

Crea un archivo llamado alterclip.desktop en ~/.local/share/applications/ con el siguiente contenido:

[Desktop Entry]
Name=Alterclip
Exec=python3 /ruta/completa/a/alterclip.py
Terminal=false
Type=Application
Icon=utilities-terminal
Categories=Utility;

🔧 Importante: Asegúrate de reemplazar /ruta/completa/a/alterclip.py con la ruta real al script principal de Alterclip.

2. Dar permisos de ejecución

Dale permisos de ejecución al archivo .desktop:

chmod +x ~/.local/share/applications/alterclip.desktop

3. Ejecutar Alterclip con gtk-launch

Una vez creado el archivo .desktop, puedes lanzar Alterclip desde la terminal con:

gtk-launch alterclip

🧠 Nota: El argumento que se pasa a gtk-launch debe coincidir con el valor de Name= en el archivo .desktop, en minúsculas y sin espacios. Si tienes dudas, también puedes usar el nombre del archivo sin la extensión: gtk-launch alterclip.

📝 Licencia

Este proyecto está licenciado bajo la GNU GPL v3.

🙌 Créditos

Creado por [mhyst].
Inspirado en la necesidad de compartir enlaces sin bloqueos ni rastreadores.