Tema macOS para Joplin

Tema nativo con apariencia macOS para la aplicación de toma de notas Joplin v2.2.4 y superior. También funciona en dispositivos que no son macOS.

• ✨ Interfaz completamente estilizada, incluyendo todos los controles,
• 🌜 Elige entre claro, oscuro, claro con barra lateral oscura o automático (claro/oscuro basado en preferencias del sistema),
• 👌 Usa íconos nativos (solo macOS) o la familia de íconos Phosphor,
• 👨‍🎨 Fácil de personalizar vía las preferencias de Joplin.

Instalación

• Abre las preferencias de Joplin › 'Plugins', busca 'macOS theme' e instala el tema.
• Reinicia Joplin. ¡Disfruta!

Asegúrate de configurar ‘Apariencia › Tema’ en ‘Claro’ o ‘Oscuro’. Si experimentas un parpadeo al cambiar de cuadernos, sincroniza la configuración Claro/Oscuro bajo ‘Apariencia › Tema’ con el valor seleccionado en ‘macOS theme › Apariencia’. Para más opciones de personalización, consulta abajo.

Personalización

Después de instalar, encontrarás un ítem extra llamado 'macOS theme' en las preferencias de Joplin. Debes reiniciar Joplin para que los cambios se apliquen.

Usuarios Mac: Si quieres usar los íconos nativos, descarga e instala SF Pro desde el sitio web de Apple aquí.

¿No hay íconos?

Usuarios Windows: Si los íconos aparecen como cuadros vacíos o faltantes, necesitas instalar manualmente la fuente Phosphor. Descárgala en phosphoricons.com (descarga directa), descomprime el archivo, instala Fonts/regular/Phosphor.ttf y reinicia Joplin.

Usuarios Mac: Si tienes la configuración 'Familia de íconos' en 'macOS nativo (SF Pro)', necesitas tener SF Pro instalado desde el sitio web de Apple. Nota que esto solo funciona en dispositivos macOS.

Descargo de responsabilidad

⚠️ Joplin usa styled-components para el estilo, lo que hace muy difícil tematizar la app. Se usaron muchos trucos CSS y !important. Esto puede causar problemas de interfaz en futuras versiones de Joplin. Como solo es CSS, tus datos permanecen seguros y puedes revertir los estilos fácilmente.

No dudes en crear un issue o publicar un mensaje en el foro si encuentras problemas.

Ayuda, obtengo una pantalla en blanco después de instalar el plugin.

Si experimentas una pantalla en blanco tras instalar el plugin, probablemente sea por un problema con el manejo de emojis. Aquí te explicamos cómo solucionarlo:

• Primero, localiza el directorio de configuración de Joplin:
• macOS: ~/.config/joplin-desktop
• Windows: %APPDATA%\Joplin
• Linux: ~/.config/Joplin
• Navega a la carpeta plugins y elimina el archivo .jpl del plugin de tema para macOS.
• Reinicia Joplin.

Prevención

Para evitar que este problema ocurra:

• En lugar de usar el diálogo "Elegir emoji..." de Joplin, añade emojis directamente en el cuadro de texto del título del cuaderno (consulta esta discusión para una referencia visual).
• Ahora puedes reinstalar el plugin.

Desarrollo

Puedes ajustar el tema a través de las preferencias de Joplin. Si quieres ir a fondo, sigue los siguientes pasos para crear tu propia versión.

Instala las dependencias:

npm install

Para construir el complemento:

npm run dist

Para actualizar el marco del complemento:

npm run update

Para compilar el CSS y vigilar los cambios:

npm run dev

El CSS generado estará disponible en: http://localhost:8080/macos-theme-for-joplin.css

Contribuir

¡Las contribuciones (especialmente correcciones) son muy bienvenidas!

Flujo de trabajo de desarrollo

Tener que reiniciar Joplin en cada cambio es un poco molesto. Para acelerar las cosas y acortar el ciclo de retroalimentación:

• Ejecuta npm run dev. Esto vigilará los cambios en los archivos .scss y reconstruirá el CSS.
• Activa las herramientas de desarrollo de Joplin (Ayuda › Alternar herramientas de desarrollo)
• Elige uno de los dos métodos de actualización de este gist.
• Pega y ejecuta el script en la consola de las herramientas de desarrollo para actualizar el CSS automáticamente.

Esto funciona bien la mayoría de las veces, pero ten en cuenta que en algunos casos los estilos cambiados interfieren con los estilos del plugin instalado. Para comprobar si ese es el caso, puedes asegurar un entorno limpio mediante:

• Desinstalar el plugin del tema macOS si ya está instalado.
• Ejecutar una compilación: npm run build
• En Joplin, ve a Plugins › Mostrar configuración avanzada.
• Bajo Plugins de desarrollo, pega la ruta a tu carpeta dist.
• Reinicia Joplin para cargar tu compilación local del plugin.

--- Tranlated By Open Ai Tx | Last indexed: 2026-03-23 ---