Blog del Podcast

nncli. Notas desde el terminal con Nextcloud Notes

Tiempo estimado de lectura: 6 minutos. 716 palabras. nextcloud

nncli es un fork de la aplicación sncli, desarrollada en Python que da acceso a tu servidor de notas de Nextcloud a través de la línea de comando.

Puedes acceder a tus notas a través de una GUI de consola personalizable que implementa atajos tipo vi o mediante una interfaz de línea de comandos simple que puedes escribir.

Instalación

sudo pip3 install nncli

Archivo de configuración

La ruta del archivo por defecto es ~/.config/nncli/config. Utilizar otra ruta del archivo de configuración

Si queremos utilizar una ruta personalizada, utilizaremos la opción -c.

nncli -c ~/emacs/nncli

Configurar el usuario y contraseña

La plantilla del archivo de configuración, utilizando de editor vim, sería:

[nncli]
cfg_nn_username = angel
cfg_nn_password = Contraseña
cfg_nn_host     = nexcloud.midominio.duckdns.org
cfg_editor = vim +{line}

Sustituye el usuario y contraseña por los tuyos Cambiando el editor de texto para las notas

Si quisieras editar con el editor de textos emacs, utilizariamos la siguiente variable en el archivo de configuración:

Ahora añadiremos esta línea al archivo:

cfg_editor = emacs -q -nw +{line}

Si quisieras utilizar nano

cfg_editor = nano +{line}

Sincronizar

Realiza una sincronización bidireccional completa entre el caché de notas local y el servidor de NextCloud Notes.

La primera vez que iniciamos nncli o tras un largo periodo de tiempo, si hemos creado más notas con otro cliente, es necesario hacer una sincronización.

Para ello utilizaremos la opción sync.

nncli sync

Esta sincronización descargará todas las notas del servidor a local para poder acceder sin problemas.

Recuerda que si tienes muchas notas, esta primera sincronización puede ser lenta, ten paciencia.

Cache y logs

La ruta de la caché de notas local y logs, está situada en ~/.cache/nncli/.

Podemos especificar una ruta concreta mediante la variable cfg_db_path.

Atajos

Los atajos son prácticamente los mismos que utilizamos en vim. Movimiento

j -> Moverse por el listado de notas hacia abajo
k -> Moverse por el listado de notas hacia arriba
J -> Estando dentro de una nota, ver la siguiente
K -> Estando dentro de una nota, ver la anterior
Space -> Página hacia abajo
b -> Página hacia arriba
s -> Ver el estado y cambiar el estado con el servidor (Online)
l -> logs

Crea Notas, editar,…

C -> Crear una nueva nota
e -> Editar nota
Enter -> Ver nota
/ -> Buscar
d -> Ordenar por fecha
A -> Limpiar búsqueda
Ctrl + t -> Ordenar por etiquetas
T -> Enviar una nota a la papelera (Te pide confirmación, antes de harcerlo).
p -> Añadir pin a una nota
m -> Marcar la nota como markdown
t -> Añadir etiqueta a una nota

Opciones para salir

Como en vim:

:w -> Guardar
:Q! -> Forzar la salida
:q -> Salir
:q! -> Forzar la salida
:wq -> Grabar y salir

Ayuda

h -> Ayuda

nncli --help
Usage: nncli [OPTIONS] COMMAND [ARGS]...

Run the NextClound Note Command Line Interface. No COMMAND means to open
the console GUI.

Options:
-n, --nosync       Don't perform a server sync.
-v, --verbose      Print verbose output.
-c, --config PATH  Specify the config file to read from.
-k, --key INTEGER  Specify the note key.
--version          Show the version and exit.
--help             Show this message and exit.

Commands:
cat         Operate on the note category.
create      Add a new note.
delete      Delete an existing note.
dump        Print note contents to stdout.
edit        Edit an existing note.
export      Print JSON-formatted note to stdout.
favorite    Mark as note as a favorite.
import      Import a JSON note.
list        List notes.
sync        Sync notes to server.
unfavorite  Remove favorite flag from a note.

Fuentes

https://nncli.org/configuration.html

Publicado por Angel el Thursday 25 March del 2021