Blog del Podcast

Shaarli cli

Gracias a esta aplicación desarrollada en Python, puedo acceder a mi instancia de Shaarli.

Vamos a ver como es su instalación y configuración.

Instalación


pip3 install shaarli-client

Configuración

Creamos el archivo de configuración:

Creamos el directorio del archivo de configuración:


mkdir ~/.config/shaarli/

Creamos el archivo:


~/.config/shaarli/client.ini

Voy a añadir mi instancia:

secret es el número Api secret que encontraremos en nuestra instancia, en el apartado Tools >> Configure


[shaarli]
url = https://shaarli.midominio.duckdns.org
secret = s3kwev7!

[shaarli:rp]
url = https://192.168.1.100
secret = m0dq3g3s

En este ejemplo he puesto dos instancias diferentes. La primera es la que utilizaré por defecto.

Uso

Poniendo shaarli en la terminal nos mostrará la ayuda.


shaarli

Toda la información que nos va a dar shaarli-client, es en formato json. Para filtrar mejor el contenido, he instalado jq.


sudo apt install jq

Información de la Instancia


shaarli get-info

Obtener links

Este comando nos muestra las últimos enlaces añadidos.


shaarli get-links

Como no me aclaro mucho con jq. Voy ayudarme de grep que lo conozco mejor:

Filtrando título


shaarli get-links | jq | grep title

Para mostrarlo limpio:


shaarli get-links | jq | grep title | sed s'|"title": "||'g | sed s'|",$||'g

Enviar urls a shaarli


shaarli post-link --url https://url --description

--url: Enlace
--description: Texto descripción del enlace
--title: Título
--private: Privado

En este ejemplo no he añadido la descripción, ya que no es obligatoria:


shaarli post-link --url https://ugeek.github.io/blog/post/2021-07-2-comandos-docker-para-guardar-imagen.html

Enviar urls a shaarli como enlace privado

Para añadir un enlace como privado, añadiremos al final la etiqueta --private.


shaarli post-link --url https://url.. --description "Descripción"  --private

Listar etiquetas


shaarli get-tags --limit 5

Conclusión

Esta es una guía introductoria a la aplicación Shaarli para terminal, pero te recomiendo acudir a la información o ayuda de la aplicación para ver más opciones.

Fuentes

https://github.com/shaarli/python-shaarli-client
https://python-shaarli-client.readthedocs.io/en/latest/user/installation.html
https://pypi.org/project/shaarli-client/

Publicado por Angel el Sunday 11 July del 2021