🚀 Big News: Socket Acquires Coana to Bring Reachability Analysis to Every Appsec Team.Learn more
Socket
DemoInstallSign in
Socket

alterclip

Package Overview
Dependencies
Maintainers
1
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

alterclip

Herramienta para interceptar URLs desde el portapapeles y modificarlas o reproducirlas

0.2.5
PyPI
Maintainers
1

🧠 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.
  • 🧠 Decide automáticamente si cambiar o no un texto según su contenido.
  • 📦 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).

🔧 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

Ejemplos de uso:

# Ver historial completo
./alterclip-cli history

# Ver solo las últimas 5 entradas
./alterclip-cli history --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 remove 123

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

# Ver ayuda completa
./alterclip-cli help

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

OriginalReemplazo
x.comfixupx.com
tiktok.comtfxktok.com
twitter.comfixupx.com
fixupx.comtwixtter.com
reddit.comreddxt.com
onlyfans.com0nlyfans.net
patreon.compxtreon.com
pornhub.compxrnhub.com
nhentai.netnhentaix.net
discord.ggdisxcord.gg
discord.comdiscxrd.com
mediafire.commediaf1re.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.

FAQs

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts