Skip to content

Repository files navigation

Forocoches Premium verified

Visualizaciones GitHub Release

Userscript que mejora Forocoches: Oculta hilos por usuarios ignorados y palabras clave, ignora mensajes de usuarios, poles automáticas, bloquea toda la publicidad, entre otras funciones. Compatible con móvil y PC (todos los diseños).

⚠️ Aviso importante: Este proyecto es un proyecto independiente y no oficial. No está afiliado, asociado, autorizado, respaldado ni en modo alguno vinculado a Forocoches.com. Forocoches.com es una marca registrada de sus respectivos propietarios. Este proyecto no representa a Forocoches.com ni forma parte del mismo equipo, negocio o marca.


✨ Funcionalidades

Ocultar hilos

  • Por palabras clave en el titulo (sin acentos, insensitive)
  • Por autor (solo Desktop-v2, no Desktop-v1)
  • Muestra resumen de hilos ocultados con enlaces y motivo

Resaltar hilos sin respuestas

  • Marca los hilos con 0 mensajes con un color de fondo configurable (selector de color incluido)

Grupos de resaltado

  • Crea grupos de usuarios para resaltar todos los hilos de ciertos autores con un color personalizado
  • Crea grupos de palabras para resaltar hilos cuyo título contenga ciertas palabras clave
  • Cada grupo tiene su propio color y descripción
  • Prioridad configurable sobre el ocultado: si un hilo coincide con un grupo de resaltado, no se oculta aunque cumpla criterios de ocultado

Resaltar mensajes del OP

  • Marca los mensajes del autor del hilo (OP) con un color de fondo y un borde distintivo
  • Incluye etiqueta 📌 OP para identificar rapidamente al creador del hilo
  • Compatible con los 4 diseños
  • Color configurable desde el panel

Ocultar mensajes

  • Oculta mensajes de usuarios ignorados automaticamente
  • Opcion de mostrar placeholder "Mensaje de usuario ignorado" en lugar de ocultar completamente
  • Opcion de desactivar la ocultación de mensajes por completo

Botones "Ignorar" en cada mensaje

  • Se inyecta un enlace Ignorar junto a los botones "Citar", responder y denunciar.
  • Añade al usuario a la lista local y a la lista de ignorados de Forocoches
  • Oculta el post al instante

Notas de usuarios

  • Añade una nota privada a cualquier usuario desde sus mensajes (icono ✏️/📝 junto a "Denunciar")
  • La nota se guarda en localStorage y se muestra en el perfil del usuario (member.php)
  • Desde el perfil puedes ver, editar o eliminar la nota

Botón Pole (🏎️)

  • Busca automaticamente el primer hilo sin respuestas en la pagina actual
  • Si no encuentra, busca en paginas siguientes (hasta 35 paginas)
  • Rellena el mensaje configurado y hace clic en Enviar
  • Configurable desde el panel (mensaje a enviar, páginas siguientes)

Panel flotante

  • Acceso rapido desde cualquier pagina via boton circular (icono de FC)
  • 4 pestañas:
    • Usuarios: ver, anadir, eliminar, buscar por username, sincronizar con FC, eliminar todos
    • Palabras: editor de palabras clave + categorias predefinidas (Politica, Futbol, Anime, Videojuegos, Cripto, +18)
    • Config: varias opciones de configuracion + exportar/importar
    • Logs: registro de depuracion con botones Limpiar/Copiar

Botones flotantes extra

  • ▲ Subir arriba — scroll suave al inicio
  • ▼ Bajar abajo — scroll a la caja de comentarios (o al final de pagina)
  • Cada boton se oculta individualmente desde configuracion

Eliminar publicidad y elementos molestos

  • Bloquea toda la publicidad (optidigital, banners flotantes, skyscraper)
  • Elimina avisos, noticias promocionadas y barra de cookies (#infocookie, #vbnotices)
  • Elimina contenedores vacíos y placeholders de anuncios que distraen
  • Elimina el botón nativo de "subir" para no duplicar funcionalidad
  • Funciona en todos los diseños: Mobile-v1 (móvil antiguo), Mobile-v2 (móvil nuevo), Desktop-v1 (PC antiguo) y Desktop-v2 (PC nuevo)
  • Configurable desde el panel (activar/desactivar por separado publicidad y avisos)

Integracion con Forocoches real

  • Sincroniza la lista de ignorados de FC
  • Anade/elimina usuarios directamente

Soporte multiplataforma

  • 4 diseños detectados automáticamente: Mobile-v1 (móvil antiguo), Mobile-v2 (móvil nuevo), Desktop-v1 (PC antiguo) y Desktop-v2 (PC nuevo)
  • Adaptadores especificos para cada diseño (post containers, selectores, extraccion de datos)

Exportar / Importar configuracion

  • Exporta configuracion y listas de palabras a archivo JSON
  • Importa desde JSON para restaurar datos

Deteccion de navegacion

  • History API monkey-patched (pushState/replaceState) + evento popstate para navegacion SPA
  • MutationObserver para contenido dinamico (debounced a 150ms)
  • Runs diferidos a 500ms (cambio de URL) y 1s (inicio)

📦 Instalacion

En iOS Safari

iOS no soporta Tampermonkey directamente, pero puedes usar la extension Userscripts.
Instala Userscripts desde la App Store.
Una vez instalado Userscripts, tienes 2 opciones para seguir con la instalación:

Opción 1 (automático)

  1. Accede a este link desde tu navegador.
  2. Desplazate a la parte superior izquierda de tu navegador y entra en Userscripts
  3. Te pedirá permisos para instalar dicho script, simplemente permitelo.
  4. Userscripts lo detectara automaticamente y hará el resto, asegurate que esté habilitado el Script.

Opción 2 (manual)

  1. Abre la app Archivos o cualquier gestor y crea una carpeta llamada Userscripts (por ejemplo en iCloud Drive)
  2. Abre la app Userscripts y configura la carpeta Userscripts como directorio de scripts
  3. Descarga forocoches-premium.user.js y guardalo en la anterior carpeta que has establecido como directorio para tus Scripts.
  4. Una vez esté en la carpeta que has creado, Userscripts lo detectara automaticamente.

💡 Tip: Si tienes problemas, asegurate de que la extension Userscripts este activada en Safari.

En Android

Android soporta Tampermonkey directamente en los navegadores compatibles.

Opción 1: Kiwi Browser (Chromium, recomendado)

  1. Instala Kiwi Browser desde Google Play
  2. Instala Tampermonkey desde Chrome Web Store
  3. Abre este link y toca Instalar

Opción 2: Firefox Android

  1. Instala Firefox Nightly desde Google Play
  2. Instala Tampermonkey desde Firefox Add-ons
  3. Abre este link y toca Instalar

En PC (Windows, macOS, Linux)

  1. Instala la extensión Tampermonkey (Chrome, Edge, Opera, Brave) o Greasemonkey (Firefox)
  2. Abre este link y pulsa Instalar

⚙️ Opciones de configuracion

Opcion Default Descripcion
Auto-minimizar al añadir/eliminar usuarios ✅ ON Cierra el panel al modificar la lista
Auto-minimizar al guardar palabras ❌ OFF Cierra el panel al guardar palabras
Ocultar hilos por autor ✅ ON Oculta hilos cuyo creador este en tu lista (solo v2)
Resaltar hilos sin respuestas ✅ ON Marca hilos con 0 mensajes con color de fondo
Color de resaltado #FFF3CD Color de fondo para hilos sin respuestas
Mostrar placeholder al ocultar ✅ ON Muestra "Mensaje de usuario ignorado" en lugar de ocultar
Desactivar ocultación de mensajes ❌ OFF No oculta mensajes de ignorados
Redirigir al subforo al ignorar OP ✅ ON Vuelve al listado tras ignorar al OP
Recargar pagina al ignorar ✅ ON Recarga tras ignorar un usuario
Boton Subir arriba ✅ ON Muestra el boton ▲
Boton Bajar abajo ✅ ON Muestra el boton ▼
Botón Pole ✅ ON Muestra el boton 🏎️ para pole automatica
Mensaje para Pole "Pole" Texto a enviar en la pole (puedes poner incluso un gif o cualquier cosa)
Buscar en páginas siguientes ✅ ON Busca en paginas siguientes si no hay hilos sin respuestas (hasta 35)
Bloquear publicidad ✅ ON Elimina banners y anuncios (optidigital, flotantes, skyscraper)
Ocultar avisos ✅ ON Oculta mensajes de aviso, noticias promocionadas y cookies

📝 Categorias predefinidas de palabras

Categoria Palabras incluidas
Politica politica, gobierno, pedro sanchez, pp, psoe, vox, elecciones, impuesto, corrupcion...
Futbol futbol, real madrid, barcelona, champions, messi, vinicius, mbappe, penalty...
Anime anime, naruto, one piece, dragon ball, attack on titan, death note, evangelion...
Videojuegos videojuego, ps5, xbox, minecraft, fortnite, gta, elden ring, league of legends...
Cripto bitcoin, ethereum, solana, nft, blockchain, defi, trading...
+18 +18, oslafo, osfo, nsfw, contenido sensible, sexo, porno...
TODO Todas las categorias juntas

🔧 Compilar desde codigo fuente

# Requisitos: Node.js >= 18
git clone <repo>
cd forocoches-premium
npm install
npm run build          # genera dist/forocoches-premium.user.js
npm run dev            # modo watch para desarrollo

Stack tecnico

  • TypeScript 5
  • Vite 6
  • vite-plugin-monkey
  • esbuild
  • Sin dependencias runtime (solo DOM APIs + localStorage)

📁 Estructura del proyecto

src/
├── main.ts           # Entry point: init, URL polling, deferred runs
├── runner.ts         # Deteccion de pagina y orquestacion
├── dom-adapter.ts    # Adapter pattern: theme detection + DOM ops
├── config.ts         # Getters/setters de configuracion
├── storage.ts        # Persistencia en localStorage
├── types.ts          # Interfaces TypeScript
├── threads.ts        # Parseo de DOM para extraer hilos
├── hide-threads.ts   # Ocultar hilos en forumdisplay
├── hide-posts.ts     # Ocultar posts + botones Ignorar
├── hide-ads.ts       # Bloqueo de publicidad y elementos molestos
├── ignore-fc.ts      # Integracion con FC (scrape + POST)
├── fc-api.ts         # Helpers para API de FC
├── observer.ts       # MutationObserver
├── toast.ts          # Notificaciones toast + logs
├── selectors.ts      # Selectores DOM
├── utils.ts          # Utilidades de texto
└── ui/
    ├── index.ts      # Orquestador: panel, botones, tabs
    ├── tab-users.ts  # Pestaña Usuarios
    ├── tab-words.ts  # Pestaña Palabras
    ├── tab-config.ts # Pestaña Config
    ├── tab-logs.ts   # Pestaña Logs
    ├── presets.ts    # Categorias predefinidas
    └── styles.ts     # Estilos CSS

📋 TODO


📄 Licencia

MIT

About

Userscript que mejora Forocoches ocultando hilos por palabras clave, opción de ignorar en mensaje, oculta mensajes de usuarios automaticamente, y mas.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages