Thanks to visit codestin.com
Credit goes to github.com

Skip to content

galiprandi/ge-emoji-ai

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Emoji Al - Gnome Shell Extension 🔎💡😊

Encuentra y sugiere emojis de forma inteligente. Acceso rápido con interfaz tipo Spotlight.

Emoji Al es una extensión para Gnome Shell (48+) diseñada para hacer que encontrar y usar emojis sea rápido, fácil e intuitivo.

Características Planeadas (y Actuales)

  • Indicador en el Panel: Un icono en el panel superior para acceso rápido (funcionalidad básica actual).
  • Atajo de Teclado Global: Invoca la interfaz de Emoji Al con una combinación de teclas configurable (funcionalidad básica actual).
  • 🚧 Interfaz tipo Spotlight: Una ventana modal centrada para todas las interacciones.
  • 🚧 Búsqueda Rápida de Emojis: Busca por nombre o palabra clave.
  • 🚧 Galería de Emojis: Visualiza emojis con selector de tono de piel.
  • 🚧 Sugerencias con IA (Local): Escribe lo que quieres expresar y "Al" te sugerirá los emojis más adecuados, usando un modelo LLM ligero que se ejecuta localmente.
  • 🚧 Emojis Recientes y Favoritos: Acceso rápido a tus emojis más usados o marcados.
  • 🚧 Copiado Fácil: Copia emojis al portapapeles con un clic.
  • 🚧 (Posible) Soporte para Kaomojis.
  • Configurable: Opciones disponibles en la ventana de preferencias de la extensión (atajo configurable).

(Leyenda: ✅ = Implementado (básico), 🚧 = Planeado/En desarrollo)

Instalación

Método 1: Desde extensions.gnome.org (Recomendado para usuarios)

  1. Visita la página de Emoji Al en extensions.gnome.org (Enlace a ser actualizado cuando se publique).
  2. Haz clic en el interruptor "ON".
  3. Confirma la instalación si se te solicita.

Método 2: Instalación Manual (para desarrollo o si no está en EGO)

  1. Descarga:

    • Clona este repositorio:
      git clone https://github.com/galiprandi/ge-emoji-ai.git
      cd ge-emoji-ai
    • O descarga el archivo .zip desde la página de Releases (si está disponible).
  2. Empaqueta (si clonaste el repo): Asegúrate de que el UUID en metadata.json sea [email protected] (o el que hayas configurado).

    UUID=$(jq -r .uuid metadata.json)
    zip -r "${UUID}.zip" . -x ".git/*" "*.zip" "README.md" "recipe.md" ".vscode/*" "node_modules/*" "dist/*" "__pycache__/*" "*.pyc"
  3. Instala:

    # Reemplaza ${UUID}.zip con el nombre real del archivo si lo descargaste manualmente
    gnome-extensions install --force "${UUID}.zip"
  4. Habilita:

    • Abre la aplicación "Extensiones" (Gnome Tweaks en versiones antiguas) y activa "Emoji Al".
    • Reinicia Gnome Shell: Presiona Alt + F2, escribe r, y presiona Enter (solo en X11). En Wayland, cierra sesión y vuelve a iniciarla.

Uso

  • Atajo de Teclado: Presiona <Super>+<Alt>+E (configurable en las preferencias) para abrir la interfaz de Emoji Al.
  • Clic en el Indicador del Panel: (Funcionalidad futura para abrir la interfaz).

🛠️ Desarrollo

Configuración Inicial

  1. Clona el repositorio:

    git clone https://github.com/galiprandi/ge-emoji-ai.git
    cd ge-emoji-ai
  2. Instala las dependencias de desarrollo (si las hay):

    # Ejemplo si usas npm/yarn para dependencias de frontend
    # npm install

Flujo de Trabajo

  1. Actualización Rápida (después de hacer cambios):

    ./scripts/update.sh

    Este script:

    • Copia los archivos al directorio de la extensión
    • Compila los esquemas
    • Establece los permisos necesarios
  2. Reinicia GNOME Shell para ver los cambios:

    • Presiona Alt+F2, escribe r y presiona Enter
    • O desde terminal:
      busctl --user call org.gnome.Shell /org/gnome/Shell org.gnome.Shell Eval s 'Meta.restart("Restarting...")'

Depuración

  1. Ver errores en tiempo real:

    journalctl -f -o cat /usr/bin/gnome-shell | grep -i "error\\|emoji"
  2. Ver todos los mensajes de la extensión:

    journalctl -f -o cat /usr/bin/gnome-shell | grep -i "emoji"

Empaquetado

Para crear un archivo ZIP listo para distribución:

./scripts/package.sh

Esto generará un archivo [email protected] que puedes compartir o instalar.

Esquemas y Preferencias

Si modificas los esquemas (schemas/*.gschema.xml):

  1. Asegúrate de que el ID del esquema coincida con settings-schema en metadata.json
  2. Ejecuta el script de actualización para compilar los esquemas
  3. Reinicia GNOME Shell para aplicar los cambios

Convenciones de Código

  • Usa ESLint/Prettier siguiendo el estándar de JavaScript
  • Documenta funciones y componentes principales
  • Mantén los commits atómicos y con mensajes descriptivos

Contribuciones

Las contribuciones son bienvenidas. Por favor, abre un issue para discutir cambios importantes o reportar bugs. Los Pull Requests también son bienvenidos.

Licencia

Este proyecto está bajo la licencia MIT (Añade un archivo LICENSE si lo deseas, MIT es una opción común).

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published