rawBlog

Tmuxinator - fast tmux setups

Tue, 27 Mar 2018 12:51:23 -0300

Ya hace tiempo que venía utilizando Tmux como ‘terminal multiplexer’, tanto para trabajo como otras tareas habituales. Algo que me molestaba era que ante cualquier reinicio perdía el ‘estado’ de mis sesiones de tmux. Por lo tanto, tenía que volver a crear mis N sesiones y en cada una abrir las múltiples aplicaciones, servicios y entornos de desarrollo teniendo en cuenta también de activar el virtualenv correspondiente a cada proyecto en cada tab dentro de tmux, algo engorroso de hacer.

Previamente había utilizado los plugins de tmux: tmux-resurrect y tmux-continuum con los cuales me guardaba automáticamente el estado de las sesiones cada tanto, y ante un reinicio este me creaba todas las sesiones anteriormente creadas con los tabs y paneles correspondientes, pero con esto no mantenía ni las apps, ni servicios, ni los virtualenv ejecutados.

Y hace poco me encontré con este post que me iluminó de la existencia de Tmuxinator contenida en una gema Ruby, este me resuelve en mayor medida lo que venía necesitando. Prácticamente este te deja crear una config .yml donde definir la creación de sesiones ‘custom’ en tmux.

Instalación y configuración

Siguiendo los pasos de instalación y configuración en el mismo repo. (Warning: los resultados y pasos efectuados son en mi entorno con Archlinux, estos pueden variar en tu caso.)

Instalación

Primero instalamos la gema:

gem install tmuxinator

Consola

Hay que asegurarse que tengamos definida la variable de editor default $EDITOR. En mi caso usando zsh, en la config ~/.zshrc la tengo definida como export EDITOR="vim".

Tmux

Tmuxinator funciona para versiones de 1.8 en adelante, exceptuando la versión 2.5. Vemos la versión haciendo en consola tmux -V en mi caso me devuelve tmux 2.6. Además si utilizamos en nuestra config de tmux (/etc/tmux.conf) la opción base-index distinta a la default (que es 0) también hay que setear pane-base-index. En mi caso entonces, tengo:

[..]
set -g base-index 1
set-window-option -g pane-base-index 1
[..]

Completion

Para conseguir autocompletado de los comandos de tmuxinator en la consola, hay que hacer un source sobre los que correspondan a tu shell. En mi caso, haciendo uso de zsh en ~/.zshrc encuentro el archivo de completion haciendo source ~/.gem/ruby/2.5.0/gems/tmuxinator-0.10.1/completion/tmuxinator.zsh.

Verificación

Podemos ahora hacer un tmuxinator doctor para confirmar que tenemos todo lo necesario instalado y configurado. Si nos muestra algo como esto:

Checking if tmux is installed ==> Yes
Checking if $EDITOR is set ==> Yes
Checking if $SHELL is set ==> Yes

Estamos listos. En caso contrario, vuelvan a leer los pasos anteriores a ver qué les faltó. Y/o lean el error y resuelvan.

Ahora ¿cómo lo uso?

Para crear una nueva config de tmuxinator, simplemente hacemos:

tmuxinator new foobar

Esto nos crea un nueva config en ~/.config/tmuxinator/foobar.yml con contenido de ejemplo para completar.

Editando config

Una vez creada esta nueva config, la abrimos con nuestro editor de preferencia y podemos ver entre los distintos parámetros cosas como:

name: setea nombre del proyecto de tmuxinator.
root: la ruta raíz de nuestro proyecto sobre el que se ejecutan todas las operaciones. Por default abre cualquier tab de tmux sobre este directorio.
on_project_first_start: ejecuta lo que pongamos en esta línea al iniciar el proyecto con tmuxinator start foobar (útil para inicializar servicios, como base de datos).
pre_window: ejecuta esta línea sobre cada nueva window abierta en tmux (muy útil para inicializar virtualenvs).
windows: acá definimos la estructura de windows por nombre y qué se ejecuta inicialmente en cada una. De similar forma se pueden gestionar los tabs y panes, además del layout en cada uno.

Esta es un ejemplo de configuración propia sobre un proyecto Django:

# ~/.tmuxinator/django_project.yml

name: django_project
root: ~/work/django_project/

on_project_first_start: sudo systemctl start mysqld.service && sudo systemctl start postgresql.service

pre_window: workon django_project

startup_window: vim

windows:
  - vim: vim
  - server: ./manage.py runserver --configuration=Dev
  - test:
  - python: ./manage.py shell
  - zsh:

Otras opciones

tmuxinator list nos lista todos nuestros proyectos creados en tmuxinator.
tmuxinator delete foobar borra el proyecto foobar.

Pueden ver otras opciones disponibles haciendo tmuxinator --help.

Extra

Una comodidad extra que nos brinda este workflow es que al cambiar de branch sobre un proyecto, si este tiene varios servicios y/o comandos que se tienen que verificar o ejecutar al levantar este proyecto. Podemos simplemente hacer un kill-session sobre tmux y volver a inicializar el proyecto con tmuxinator.

Espero les sea tan útil como me es útil a mí. Lo utilizo para prácticamente todos mis proyectos en desarrollo e incluso para otros casos recurrentes, como una sesión para escribir en este mismo blog ;).

Lector de Huella en Thinkpad X1 Carbon 4th Gen

Fri, 23 Mar 2018 21:00:59 -0300

Lo único que no funcionaba en mi X1 sobre linux era el lector de huella, un lujo que era prescindible. Hace tiempo que venía siguiendo el progreso sobre este repo que intentaba tener un driver funcional para Linux haciendo ingeniería inversa sobre el lector.

Hace poco, armó un prototipo y pidió feedback sobre el mismo. A todo esto otro usuario, armó un driver sobre fprint en base a este prototipo dando soporte a este lector de huellas.

Warning: seguir estos pasos es bajo tu responsabilidad, los mismos me funcionaron específicamente sobre mi X1 Carbon 4th gen con Archlinux. Además de ser sobre un prototipo, un driver propiamente desarrollado está en los planes de esta misma gente para un futuro.

Estos son los pasos que seguí para lograr hacerlo funcionar, en base a lo escrito por el usuario @vKnmnn en el Gitter sobre el prototipo de @nmikhailov:

Instalar libfprint-vfs0090-git
Editar /etc/pam.d/system-auth, agregando pam_fprintd.so antes de pam_unix.so. Quedando:

[..]
auth sufficient pam_fprintd.so
auth required   pam_unix.so
[..]

Esto habilita a usar sudo con huella.

Si usás sddm como tu display manager como yo, editamos/etc/pam.d/sddm agregando pam_fprintd.so como primer línea de auth. Quedando:

  auth sufficient pam_fprintd.so
  [..]

Esto nos habilita a utilizar la huella en el login apretando enter sobre el campo vacío de contraseña previamente a utilizar la huella.

En el prototipo todavía no se puede hacer la ‘inicialización’ de las huellas. Por lo tanto desde un windows, ya sea en disco o en una máquina virtual:
- si estamos en una virtual, hay que habilitar el dispositivo usb del lector para lograr verlo en la virtual
- si no detecta el dispositivo, buscamos el driver para windows en la página de Lenovo. Yo instalé este
- vamos a Settings -> Users -> Log-in options
  - Agregamos un PIN
  - Y en la sección Windows Hello -> agregamos una huella (no hace falta agregar más que una cualquiera, es sólo para inicializar el lector)
Volviendo a nuestro linux
- registramos nuestras huellas haciendo:
  
  for finger in {left,right}-{thumb,{index,middle,ring,little}-finger}; do fprintd-enroll -f “$finger” “$USER”; done
  - Nos va a pedir dedo por dedo, y registra 5 veces cada uno antes de pasar al siguiente.
  - Podemos poner en todos los dedos a registrar un único o unos pocos, repitiendo en los que no nos interese.
Ahora haciendo uso de sudo o al intentar loguearse por sddm, nos pide una huella y el lector se enciende.

Enjoy. Me voy a mantener al tanto para cuando saquen el driver definitivo.

[Fix] GoPro Hero 4 Session WiFi Problem

Tue, 06 Feb 2018 21:55:13 -0300

Warning: esta solución me dió resultado a mí, pero quizás no sea tu caso. Queda bajo tu responsabilidad cualquier efecto provocado por seguir esta guía correcta o incorrectamente.

Mi GoPro Hero 4 Session no prendía la conexión por WiFi, la cual nos permite hacer uso de la app en el celular que entre otras cosas nos da acceso a algunas opciones que desde la propia GoPro no se pueden cambiar. Dejando limitada sus funcionalidades.

Después de más de un año de indignación, tras intentar pedir ayuda a Soporte Técnico de GoPro, que me respondía sin leer atentamente todo lo que le explicaba que ya había probado, seguía con un problema que hasta ahora parecía sin solución.

Un error que parece algo recurrente para varios clientes de este producto, para lo cual proponían básicamente dos “soluciones” actualizar el firmware de la GoPro a su última versión (lo cuál obviamente intenté sin solución alguna) o mandarles el producto en caso de que todavía esté bajo garantía para que te lo reemplazen por uno nuevo, lo cual me era imposible ya que mi compra fue fuera del país hace tiempo, quedando fuera de garantía. Poco soporte ya para un producto que queda fuera del interés de GoPro al haber lanzado ya las versiones 5 y 6 de la línea.

Investigando alternativas encontré este repo en GitHub que habría un camino posible. Ligado a eso me encontré con un post en el foro de GoPro, donde el 25 de Diciembre del 2017, recién alguien encontró una posible solución. Este propone con la SD limpia, crear los siguiente 2 archivos:

no_shutdown.txt

2_mode=0

cal.txt

_tapp factory_reset

Prendemos la GoPro como si fuésemos a grabar algo, y a los pocos segundos en el display debería aparecer Factory Sett. Restored y hace unos flash con los led de color azul. Una vez hecho el reseteado, sacamos la SD, eliminamos los archivos creados dejando la SD limpia nuevamente y volvemos a poner la SD. Una vez prendida ya debería funcionar con normalidad, al apretar la conexión por App debería ya darnos el pin para conectar con el celular. Eureka!

Probado en mi GoPro Hero 4 Session con versión de firmware v02.00.

Trizen - Alternativa Al 'Descontinuado' Pacaur

Sat, 06 Jan 2018 00:30:12 -0300

Pacaur fue durante mucho tiempo mi helper por defecto para la instalación y manejo de paquetes tanto de repos oficiales como de AUR. Y hace no mucho tiempo quien lo mantenía anunció que iba a dejar de dar soporte al proyecto.

Buscando una alternativa para un rápido cambio, cruzando la data de la tabla comparativa de helpers y este thread de Reddit donde se trató la temática, me terminé por decidir por Trizen al ofrecer la experiencia más similar.

Dando uso por última vez de pacaur para la instalación de su sucesor:

  pacaur -S trizen

Y un leve cambio en la configuración de trizen, para que los paquetes clonados se guarden en .cache en vez de /tmp:

~/.config/trizen/trizen.conf

  clone_dir => ".cache/trizen",

Podríamos desinstalar pacaur y utilizar normalmente trizen prácticamente como si de pacaur se tratase. Para más info man trizen.

PS: pongo ‘descontinuado’ ya que pacaur es open source (https://github.com/rmarquis/pacaur) y quien quiera podría agarrar la posta y continuar su desarrollo aunque su propio desarrollador principal (quien dejó el proyecto) ya no lo mantenga.

Zeal - Documentación Offline

Fri, 05 Jan 2018 19:52:07 -0300

Zeal es una gran utilidad que nos permite tener a mano una gran cantidad de documentación de distintos lenguajes y/o frameworks de los más utilizados de forma offline. Esto nos da la posibilidad de consultar documentación cuando no tenemos conexión a internet, contamos con una lenta conexión o un plan de datos limitado.

Esta utilidad la vengo utilizando con regularidad por la simple comodidad de ni tener que buscar la página online de la documentación sobre lo que esté trabajando, permitiéndome simplemente abrir Zeal con un atajo de teclado (Super + z, en mi caso) y buscar lo necesario. Sin lugar a dudas pasó a ser de gran ayuda al querer adelantar trabajo mientras estoy en algún viaje de colectivo de larga distancia donde por tramos ni tenemos conexión 3g (ni 2g, ni Edge :P).

Los Sets de documentación son obtenidos gracias a otra utilidad llamada Dash (en la cual está inspirada Zeal misma) que cumple similares funcionalidades pero es exclusivo del ecosistema de Apple. No tenemos la documentación de todo lo que se nos pase por la cabeza, pero hay una gran variedad y lo más utilizado de seguro lo encontramos. Y si no encontrás ese que tanto querés que todo el mundo utilice aunque por el momento seas uno de esos 100 en el mundo, hay formas de poder generar y aportar los docsets necesarios para que tanto los usuarios de Dash como de Zeal los tengan a su disposición.

Se la recomiendo a todo desarrollador para tener a mano la documentación de ese último nuevo framework en el que tocó trabajar.

[Workaround] Little Racers Streets crash on linux

Fri, 15 Sep 2017 15:46:32 -0300

Al querer iniciar el juego Little Racers Streets desde Steam (que por cierto es muy divertido), me tiraba un error similar a esto An error ocurred: An exception was thrown by the type initializer for System.Drawing.GDIPlus.

Encontré la solución acá, usando ArchLinux hacemos los siguiente:

  sudo pacman -S sdl2_mixer
  cd "$HOME/.local/share/Steam/steamapps/common/Little Racers STREET/lib64"
  mkdir ../bak64/
  mv libSDL2_mixer-2.0.so.0 ../bak64/
  ln -s /usr/lib/libSDL2_mixer-2.0.so.0 ./

[Workaround] Pantalla negra al iniciar aplicación hecha en Unity

Thu, 14 Sep 2017 16:15:58 -0300

Este problema me aparece con varios juegos hechos sobre Unity3d. Básicamente al iniciar en fullscreen la pantalla queda totalmente negra, en algunos casos se puede escuchar el audio dando a notar que de todas formas está iniciando.

Como workaround sobre este problema se puede hacer lo siguiente:

Primero localizamos la carpeta con las configuraciones de Unity sobre la aplicación que queremos arreglar, deberíamos encontrarla en ~/.config/unity3d/app-que-buscamos. En esta carpeta deberíamos encontrar un archivo llamado prefs. Entonces con el ejemplo anterior, la ruta sería ~/.config/unity3d/app-que-buscamos/prefs. El contenido de dicho archivo tendría que ser similar a esto:

  <unity_prefs version_major="1" version_minor="1">
    <pref name="Screenmanager Is Fullscreen mode" type="int">1</pref>
    <pref name="Screenmanager Resolution Height" type="int">1080</pref>
    <pref name="Screenmanager Resolution Width" type="int">1920</pref>
    <pref name="UnityGraphicsQuality" type="int">3</pref>
    <pref name="UnitySelectMonitor" type="int">0</pref>
    <pref name="unity.cloud_userid" type="string"> ... </pref>
    <pref name="unity.player_session_background_time" type="string"> ... </pref>
    <pref name="unity.player_session_elapsed_time" type="string"> ... </pref>
    <pref name="unity.player_sessionid" type="string"> ... </pref>
  </unity_prefs>

Recomendado hacer un copia del archivo, en mi caso hago la copia en la misma carpeta llamándolo prefs.bkp.

Lo que nos interesa modificar (sobre el archivo original) es la línea de Fullscreen mode, poniéndole como valor 0:

    <pref name="Screenmanager Is Fullscreen mode" type="int">0</pref>

Una vez modificado y guardado, procedemos a abrir la aplicación.

De forma opcional, podemos modificar los valores de Resolution Height y Resolution Width para que coincidan con la resolución de nuestro monitor. Por ejemplo si tenemos una pantalla fullHD, los valores serían 1080 y 1920 respectivamente.

Es muy probable que al cerrar e iniciar nuevamente la aplicación, estos valores que modificamos sean sobrescritos automáticamente. Tendríamos que volver a modificar nuevamente siguiendo los mismos pasos o podemos poner el archivo prefs en modo de sólo lectura, esto último lo podemos lograr haciendo uso de chattr como les explico en este otro post.

[Javascript] Toggle Icon Class - cambiar ícono con click sobre botón

Wed, 13 Sep 2017 01:31:09 -0300

Buscando una manera simple de cambiar un ícono por otro al hacer click sobre un botón, haciendo uso Javascript solamente (sin JQuery). Encontré sobre classList, en particular classList.toggle que justamente nos permite agregar o quitar una propiedad de un elemento.

En este caso estaba jugando para cambiar un ícono de FontAwesome de Play/Pause en esta sección de mi página.

Entonces simplemente encontrando mi elemento y usando toggle pude quitar la clase de “play” y agregar la clase de “pause”.

  var icon = document.getElementById('icon');
  icon.classList.toggle('fa-pause');
  icon.classList.toggle('fa-play');

Como quiero que esto ocurra cuando hago click, lo agrego como evento de click al botón.

document.getElementById('play-button').addEventListener('click', function(){
  var icon = document.getElementById('icon');
  icon.classList.toggle('fa-pause');
  icon.classList.toggle('fa-play');
})

Pueden ver los cambios completos hechos en este commit.

Chattr - Archivo No Editable (Read-only)

Tue, 12 Sep 2017 09:31:52 -0300

Si se quiere settear un archivo como read-only, para que este no pueda ser modificado. Se puede hacer uso de chattr de la siguiente manera:

  # chattr +i /path/to/file

Y para revertirlo:

  # chattr -i /path/to/file

Muy útil cuando cambiamos alguna setting de un programa y queremos que quede de forma permanente sin que sea sobrescrita por el programa mismo.

[Workaround] Problema de líneas horizontales en Konsole

Mon, 11 Sep 2017 19:16:08 -0300

En la consola de plasma Konsole, tuve un problema durante bastante tiempo y no le dí mayor importancia hasta que me decidí por arreglarlo.

El problema es que al escribir, mover el cursor o seleccionar texto en la consola me aparecían líneas horizontales a lo largo de la terminal que aparecían y desaparecían. Pensé que era cuestión de la fuente, o el theme que estaba usando.

Resulta que es un bug de Konsole que tiene con el escalado de la UI en Plasma. De modo que si modifica el escalado en Plasma, surge este problema. Yo había modificado el escalado a ‘1.1’ al empezar a utilizar Plasma en mi notebook.

Como workaround se puede poner el escalado por default en 1. Para esto vamos a ‘Displays’ buscamos ‘Scale display’ y cambiamos el valor a ‘1’. Aplicamos los cambios, y reiniciamos ‘X’ o el sistema por completo.