# Opml-to-blogroll

Script en python bastante manual basado en lo que vi en el blog de [DanQ](https://danq.me/2026/01/20/blogroll-88x31s/)

Me encantan los iconitos pixelados que pone el generador de el, pero no tengo idea de donde los saca ni he visto a nadie por este ecosistema hacer uso de ellos.

Un script de Python versátil diseñado para convertir archivos de suscripciones RSS (OPML/XML) en formatos listos para publicar en la web. Ideal para crear "blogrolls" o directorios de lectura en WordPress, blogs estáticos o documentación personal.

# Descripción (Español)

Este script permite transformar tus exportaciones de FreshRSS (o cualquier lector RSS) en piezas de contenido visualmente atractivas o estructuradas.

# Funcionalidades

- Entrada Dual: Soporta archivos .opml y .xml.
- Modo Híbrido:
  - Ejecución por línea de comandos para automatización.
  - Interfaz Gráfica (GUI) con Tkinter para un uso sencillo.
- Formatos de Salida:
  - HTML: Genera tarjetas con bordes redondeados y diseño responsivo utilizando CSS Inline (100% compatible con WordPress y otros CMS que bloquean etiquetas \<style\>).
  - Markdown: Crea tablas limpias escapando caracteres especiales (como \|) para evitar errores de formato.
  - JSON: Exporta una estructura de datos limpia para desarrolladores.
Portabilidad: No requiere librerías externas (solo Python 3.x).

# Uso

- **Gráfico**: Ejecuta python script.py sin argumentos.
- **Comandos**: python script.py archivo.opml -f markdown

# Description (English)

A versatile Python script designed to convert RSS subscription files (OPML/XML) into web-ready formats. Perfect for creating "blogrolls" or reading directories on WordPress, static blogs, or personal documentation.

# Features

- Dual Input: Supports both .opml and .xml files.
- Hybrid Mode:
  - Command Line Interface (CLI) for automation.
  - Graphical User Interface (GUI) via Tkinter for ease of use.
- Output Formats:
  - HTML: Generates responsive, rounded cards using Inline CSS (100% compatible with WordPress and CMS platforms that strip \<style\> tags).
  - Markdown: Creates clean tables with auto-escaping for special characters (like |) to ensure formatting stability.
  - JSON: Exports a clean data structure for developers.
- Portability: Built using standard Python libraries only (Python 3.x).

# Usage

- **GUI**: Run python script.py without arguments.
- **CLI**: python script.py file.opml -f html

# Instalación / Installation

Clona este repositorio / Clone this repo:
```bash
git clone https://git.interlan.ec/Drk0027/opml-to-blogroll
```

Asegúrate de tener Python instalado / Ensure Python is installed:

```bash
python main.py
```

# Licencia / License

MIT License - Siéntete libre de usarlo y mejorarlo. / Feel free to use and improve it.

# Nota de mejora:

Este script ha sido optimizado para la compatibilidad moderna con WordPress Gutenberg y motores de renderizado de Markdown estrictos, asegurando que los enlaces y estilos se mantengan intactos independientemente de la plataforma de destino.