Manual de Zenity

Detailed Instructions:
Step 1
Run update command to update package repositories and get latest package information.

sudo apt-get update -y

Step 2
Run the install command with -y flag to quickly install the packages and dependencies.

sudo apt-get install -y zenity

Introducción
Zenity le permite crear los siguientes tipos de diálogos simples:

 Calendario
 Seleccionador de archivos
 Formularios
 Lista
 Icono de notificación
 Mensajes
 Error
 Información
 Pregunta
 Advertencia
 Contraseña
 Progreso
 Entrada de texto
 Información de texto
 Escala
 Selección de color

Uso
Cuando escriba scripts, puede usar Zenity para crear diálogos simples que interactúen
gráficamente con el usuario, como por ejemplo:

 Puede crear un diálogo para obtener información del usuario. Por ejemplo, puede
pedir al usuario seleccionar una fecha de un diálogo del calendario, o seleccionar un
archivo de un diálogo de selección de archivo.

 Usted puede crear un diálogo para proporcionar información al usuario. Por ejemplo,
puede usar un diálogo de progreso para indicar el estado actual de una operación, o
usar un diálogo de advertencia para alertar al usuario.

Cuando el usuario cierra el diálogo, Zenity imprime el texto producido por diálogo a la salida

estándar de error.

Cuando usted escriba comandos de Zenity, asegúrese de poner comillas alrededor de cada
argumento.
Por ejemplo, use:

zenity --calendar --title="Calendario de vacaciones"

No use:

zenity --calendar --title=Calendario de vacaciones

Si no usa comillas, puede que consiga resultados inesperados.

Combinaciones de teclas
Una combinación de teclas le permite realizar una acción desde el teclado en lugar de utilizar
el ratón para elegir un comando de un menú o un diálogo. Cada combinación de teclas se
identifica por una letra subrayada en una opción del menú o de un diálogo.

Algunos diálogos de Zenity soportan el uso de combinaciones de teclas. Para especificar el

carácter que se utilizará como combinación de teclas, ponga un guión bajo precediendo ese
carácter en el texto del diálogo. El siguiente ejemplo muestra cómo especificar la letra «E»
como combinación de teclas:

«_Elija un nombre».

Códigos de salida
Zenity devuelve los siguientes códigos de salida:

Código de Descripción
salida

0 El usuario ha pulsado Aceptar o Cerrar.

1 El usuario ha presionado Cancelar, o ha usado la función de la ventana

para cerrar el diálogo.

-1 Ha ocurrido un error inesperado.

5 El diálogo se ha cerrado porque se alcanzó el tiempo de expiración.

Opciones generales
Todos los diálogos de Zenity soportan las siguientes opciones generales:

--title=título

Especifica el título de un diálogo.

--window-icon=ruta_al_icono

Especifica el icono que se muestra en el marco de la ventana del diálogo. Hay 4 iconos
disponibles, proporcionando las palabras claves siguientes - 'info', 'warning', 'question' y
'error'.
--width=anchura

Especifica el ancho del diálogo.

--height=altura

Especifica la altura del diálogo.

--timeout=tiempo_de_expiración

Especifica el tiempo de expiración en segundos después del cual el diálogo se cierra.

Opciones de ayuda
Zenity proporciona las siguientes opciones de ayuda:

--help

Muestra un texto de ayuda abreviado.

--help-all

Muestra un texto de ayuda completo para todos los diálogos.

--help-general

Muestra el texto de ayuda para los opciones de diálogo generales.

--help-calendar

Muestra el texto de ayuda para las opciones de diálogo del calendario.

--help-entry

Muestra el texto de ayuda para las opciones del diálogo de entrada de texto.

--help-error

Muestra el texto de ayuda para las opciones del diálogo de error.

--help-info

Muestra el texto de ayuda para las opciones del diálogo de información.

--help-file-selection

Muestra el texto de ayuda para las opciones del diálogo de selección de archivos.

--help-list

Muestra el texto de ayuda para las opciones del diálogo de lista.

--help-notification

Muestra el texto de ayuda para las opciones de iconos de notificación.

--help-progress

Muestra el texto de ayuda para las opciones del diálogo de progreso.

--help-question
Muestra el texto de ayuda para las opciones del diálogo de pregunta.

--help-warning

Muestra el texto de ayuda para las opciones del diálogo de advertencia.

--help-text-info

Muestra el texto de ayuda para las opciones del diálogo de información.

--help-misc

Muestra el texto de ayuda para las opciones misceláneas.

--help-gtk

Muestra la ayuda para las opciones de GTK+.

Opciones misceláneas
Zenity también proporciona las siguientes opciones varias:

--about

Muestra el diálogo Acerca de Zenity, que contiene la información de la versión de Zenity,

información del copyright, e información del desarrollador.

--version

Muestra el número de versión de Zenity.

Opciones de GTK+
Zenity soporta las opciones estándares de GTK+. Para obtener más información acerca de las
opciones de GTK+, ejecute el comando zenity --help-gtk.

Variables de entorno
Generalmente Zenity detecta la ventana del terminal desde la que se ha lanzado y se mantiene
por encima de esa ventana. Este comportamiento se puede desactivar con la variable de
entorno WINDOWID.

Diálogo de calendario
Use la opción --calendar para crear un diálogo de calendario. Zenity devuelve la fecha
seleccionada a la salida estándar. Si no se especifica una fecha en la línea de comando, el
diálogo usa la fecha actual.

El diálogo de calendario soporta las siguientes opciones:

--text=texto

Especifica el texto que se muestra en el diálogo del calendario.

--day=día

Especifica el día que se selecciona en el diálogo del calendario.«Día» debe ser un número entre
1 y 31 ambos incluídos.
--month=mes

Especifica el mes que se selecciona en el diálogo del calendario. «Mes» debe ser un número
entre 1 y 12 ambos incluídos.

--year=año

Especifica el año que se selecciona en el diálogo del calendario.

--date-format=formato

Especifica el formato que se devuelve desde el diálogo de calendario después de la selección

de la fecha. El formato predeterminado depende de configuración regional. «Formato» debe
ser un formato que sea compatible con la función strftime, por ejemplo %A %d/%m/%y.

El siguiente script de ejemplo muestra cómo se crea un diálogo de calendario:

#!/bin/sh
if zenity --calendar \
--title="Seleccione una fecha" \
--text="Pulse en una fecha para seleccionarla." \
--day=10 --month=8 --year=2004
then echo $?
else echo "No ha seleccionado ninguna fecha"
fi

Ejemplo de un diálogo de calendario

Diálogo de contraseña
Use la opción --password para crear un diálogo de contraseña.

El diálogo de contraseña soporta las siguientes opciones:

--username

Mostrar el campo de nombre de usuario.

El siguiente script de ejemplo muestra cómo crear un diálogo de contraseña:

#!/bin/sh
ENTRY=`zenity --password --username`
case $? in
0)
 echo "Nombre de usuario: `echo $ENTRY | cut -d'|' -f1`"
echo "Contraseña: `echo $ENTRY | cut -d'|' -f2`"
;;
1)
echo "No iniciar sesión.";;
-1)
echo "Ha ocurrido un error inesperado.";;
esac

Ejemplo de diálogo de contraseña

Diálogo de escala
Use la opción --scale para crear un diálogo de escala.

El diálogo de escala soporta las siguientes opciones:

--text=TEXTO

Establezca el texto del diálogo. (Predeterminado: «Ajustar el valor de la escala»)

--value=VALOR

Establezca el valor inicial. (Predeterminado: 0) Debe especificar un valor que esté entre los
valores mínimo y máximo.

--min-value=VALOR

Establezca el valor mínimo. (Predeteminado: 0)

--max-value=VALOR

Establezca el valor máximo. (Predeteminado: 100)

--step=VALOR

Establezca el tamaño del paso. (Predeterminado: 1)

--print-partial

Imprimir el valor a la salida estandar cuando se cambie el valor.

--hide-value

Ocultar valor en un diálogo.

El siguiente script de ejemplo muestra cómo crear un diálogo de escala:

#!/bin/sh
VALUE=`zenity --scale --text="Select window transparency." --value=50`
case $? in
0)
echo "Ha seleccionado $VALUE%.";;
1)
echo "No ha seleccionado ningún valor.";;
-1)
echo "An unexpected error has occurred.";;
esac

Ejemplo de diálogo de escala

Diálogo de formularios
Use la opción --forms para crear un diálogo de formularios.

El diálogo de formularios soporta las siguientes opciones:

--add-entry=nombre_del_campo

Añadir una entrada nueva en el diálogo de formularios.

--add-password=nombre_del_campo

Añadir una contraseña nueva en el diálogo de formularios. (Ocultar el texto)

--add-calendar=nombre_del_campo

Añadir un calendario nuevo en el diálogo de formularios.

--text=TEXTO

Establezca el texto del diálogo.

--separator=SEPARADOR

Establecer el carácter separador. (Predeterminado: «|»)

--forms-date-format=PATRÓN

Establecer el formato de la fecha que se devuelve. El formato predeterminado depende de su

configuración regional. «formato» debe ser un formato que sea compatible con la
función strftime, por ejemplo %A %d/%m/%y.

El siguiente script de ejemplo muestra cómo se crea un diálogo de formularios:

#!/bin/sh
zenity --forms --title="Añadir amigo" \
--text="Introduzca la información sobre su amigo." \
--separator="," \
--add-entry="Nombre" \
--add-entry="Apellido" \
--add-entry="Correo-e" \
--add-calendar="Cumpleaños" >> dirs.csv
case $? in
0)
echo "Amigo añadido.";;
1)
echo "No se ha añadido ningún amigo."
;;
-1)
echo "Ha ocurrido un error inesperado."
;;
Esac

Ejemplo de diálogo de formularios

Diálogo de lista

Use la opción --list para crear un diálogo de lista. Zenity devuelve las entradas en la primera

columna de texto de las filas seleccionadas a la salida estándar.

Los datos para el diálogo deben especificarse columna por columna, fila por fila. Puede
proporcionar datos al diálogo a través de la entrada estándar. Cada entrada se debe separar
por un carácter de línea nueva.

Si usa la opción --checklist o --radiolist, cada fila debe comenzar con «TRUE» o «FALSE».

El diálogo de lista soporta las siguientes opciones:

--column=columna
Especifica el encabezado de la columna mostrada en el diálogo de lista. Debe especificar una
opción --column por cada columna que quiera mostrar en el diálogo.

--checklist

Especifica que la primera columna en el diálogo de lista contiene casillas de marcado.

--radiolist

Especifica que la primera columna en el diálogo de lista contiene casillas de opción.

--editable

Permite editar los elementos mostrados.

--separator=separador

Especifica qué cadena de caracteres se utilizará cuando el diálogo de lista devuelva las
entradas seleccionadas.

--print-column=columna

Especifica qué columna debería imprimirse hasta la selección. La columna predeterminada es

'1', 'ALL' puede usarse para imprimir todas las columnas.

El siguiente script de ejemplo muestra cómo crear un diálogo de lista:

bin/sh
zenity --list \
title="Elija los fallos que quiere ver" \
column="Número del fallo" --column="Severidad" --column="Descripción" \
992383 Normal "GtkTreeView se cuelga con selecciones múltiples" \
293823 Alto "El diccionario de GNOME no manera proxys" \
393823 Crítico "El editor de menú no funciona en GNOME 2.0"
Ejemplo del diálogo de lista

Diálogo de mensaje
Para cada tipo, use la opción --text para especificar el texto que se muestra en el diálogo.

Diálogo de advertencia
Use la opción --warning para crear un diálogo de advertencia.

El siguiente script de ejemplo muestra cómo crear un diálogo de advertencia:

#!/bin/bash
zenity --warning \
--text="Desconecte el cable de eléctrico para evitar un shock eléctrico."
Ejemplo del diálogo de advertencia

Diálogo de error
Use la opción --error para crear un diálogo de error.

El siguiente script de ejemplo muestra cómo crear un diálogo de error:

#!/bin/bash
zenity --error \
--text="No se pudo encontrar /var/log/syslog."
Ejemplo de diálogo de error

Diálogo de información
Use la opción --info para crear un diálogo de información.

El siguiente script de ejemplo muestra cómo crear un diálogo de información:

#!/bin/bash
zenity --info \
--text="Merge complete. Combinación completa. Actualizados 3 de 10 archivos."
Ejemplo de diálogo de información

Diálogo de pregunta
Use la opción --question para crear un diálogo de pregunta.

El siguiente script de ejemplo muestra cómo crear un diálogo de pregunta:

#!/bin/bash
zenity --question \
--text="¿Está seguro de que quiere continuar?"

Ejemplo del diálogo de pregunta

Diálogo de progreso
Use la opción --progress para crear un diálogo de progreso.

Zenity lee línea por línea los datos desde la entrada estándar. Si una línea se antepone con #, el
texto se actualiza con el texto en esa línea. Si una línea contiene solamente un número, el
porcentaje se actualiza con ese número.

El diálogo de progreso soporta las siguientes opciones:

--text=texto

Especifica el texto que se muestra en el diálogo de progreso.

--percentage=porcentaje

Especifica el porcentaje inicial que se establece en el diálogo de progreso.

--auto-close

Cierra el diálogo de progreso cuando se ha alcanzado 100%.

--pulsate

Especifica que la barra de progreso pulse hasta que se lea un carácter EOF desde la entrada
estándar.

El siguiente script de ejemplo muestra cómo crear un diálogo de progreso:

#!/bin/sh
(
echo "10" ; sleep 1
echo "# Actualizando los registros de los correos" ; sleep 1
echo "20" ; sleep 1
echo "# Reiniciando las tareas de cron" ; sleep 1
echo "50" ; sleep 1
echo "Esta linea se ignorará" ; sleep 1
echo "75" ; sleep 1
echo "# Reiniciando el sistema" ; sleep 1
echo "100" ; sleep 1
)|
zenity --progress \
title="Actualizando los registros del sistema" \
 text="Rastreando los registros de los correos..." \
percentage=0

if [ "$?" = -1 ] ; then
zenity --error \
text="Actual
ización cancelada."
fi
Ejemplo de diálogo de progreso

Diálogo de selección de archivos

Use la opción --file-selection para crear un diálogo de selección de archivos. Zenity devuelve
los archivos o carpetas seleccionadas a la salida estándar. El modo predefinido de un diálogo
de selección de archivo es «abrir».

El diálogo de selección de archivo soporta las siguientes opciones:

--filename=nombre_de_archivo

Especifica el archivo o carpeta que se selecciona en el diálogo de selección de archivo cuando

el diálogo se muestra por primera vez.

--multiple

Permite seleccionar archivos múltiples en el diálogo de selección.

--directory

Permite solamente la selección de carpetas en el diálogo de selección de archivos.

--save

Establece el diálogo de selección de archivo en el modo «guardar».

--separator=separador

Especifica la cadena que se usará para dividir la lista de nombres de archivo devuelta.

El siguiente script de ejemplo muestra cómo crear un diálogo de selección de archivo:

#!/bin/sh
FILE=`zenity --file-selection --title="Select a File"`
case $? in
0)
echo "\"$FILE\" seleccionado.";;
1)
echo "No ha seleccionado ningún archivo.";;
 -1)
echo "Ha ocurrido un error inesperado.";;
esac

Ejemplo del diálogo de selección de archivos

Diálogo de selección de color

Use la opción --color-selection para crear un diálogo de selección de color.

El diálogo de selección de color soporta las siguientes opciones:

--color=VALOR

Establezca el color inicial ()ej: #FF0000)

--show-palette

Mostrar la paleta

El siguiente script de ejemplo muestra cómo crear un diálogo de selección de color:

#!/bin/sh
COLOR=`zenity --color-selection --show-palette`
case $? in
0)
echo "Ha seleccionado $COLOR.";;
1)
echo "No ha seleccionado ningún color.";;
-1)
echo "Ha ocurrido un error inesperado.";;
esac
Ejemplo del diálogo de selección de color

Más información
Diálogo para la entrada de texto
Use la opción -entry para crear un diálogo de entrada de texto. Zenity devuelve a la salida
estándar el contenido del texto introducido.

El diálogo de entrada de texto soporta las siguientes opciones:

--text=texto

Especifica el texto que se muestra en el diálogo de entrada de texto.

--entry-text=texto

Especifica el texto que se muestra en el campo de entrada del diálogo de entrada.

--hide-text

Oculta el texto en el campo de entrada del diálogo de entrada de texto.

El siguiente script de ejemplo muestra cómo se crea un diálogo de entrada de texto:

#!/bin/sh
if zenity --entry \
--title="Añadir un perfil nuevo" \
--text="Escriba el nombre del perfil nuevo:" \
--entry-text "NewProfile"
then echo $?
else echo "No ha especificado ningún nombre"
fi

Ejemplo de diálogo de entrada de texto

Diálogo para la texto de información

Use la opción --text-info para crear un diálogo de texto de información.
El diálogo de texto de información soporta las siguientes opciones:

--filename=nombre_de_archivo

Especifica un archivo que se carga en el diálogo de texto de información.

--editable

Permite que el texto mostrado sea editado. El texto editado se devuelve por la salida estándar
cuando el diálogo se cierra.

--font=TIPOGRAFÍA

Especifica la tipografía del texto.

--checkbox=TEXTO

Activar una casilla para usarla como «He leído y acepto los términos».

--html

Activar el soporte de HTML.

--url=URL

Establecer un URL en vez de un archivo. Sólo funciona si usa la opción «--html».

El siguiente script de ejemplo muestra cómo crear un diálogo de texto de información:

#!/bin/sh
# Debe copiar el archivo "COPYING" en la misma carpeta que este script.
FILE=`dirname $0`/COPYING

zenity --text-info \
--title="Licencia" \
--filename=$FILE \
--checkbox="He leído y acepto los términos."
case $? in
0)
echo "Comenzar instalación"
# siguiente paso
;;
1)
echo "Detener instalación"
;;
-1)
echo "Ha ocurrido un error inesperado."
;;
Esac
Ejemplo del diálogo de texto de información

Icono de notificación
Use la opción --notification para crear un icono de notificación.

--text=texto

Especifica el texto que se mostrara en el área de la notificación.

--listen=icon: «texto», message: «texto», tooltip: «texto», visible: «texto»,

Escucha comandos en la entrada estándar. Se debe especificar al menos un comando. Los

comandos se separan mediante comas. Un comando debe ir seguido de dos puntos y un valor.

El comando icon también acepta cuatro valores de iconos del almacén, tales

como error, info, question y warning.

El siguiente script de ejemplo muestra cómo crear un icono de notificación:

#!/bin/sh
zenity --notification\
--window-icon="info" \
--text="Hay actualizaciones necesarias para su sistema"
Ejemplo de icono de notificación

El siguiente script de ejemplo muestra cómo crear un icono de notificación con --listen:

#!/bin/sh
cat <<EOH| zenity --notification --listen
message: este es el mensaje de texto
EOH
Ejemplo de icono de notificación con --listen