= Introducción =

Mi portátil es un ordenador Acer 5755G con las siguientes características:

* Core i5 2430M 2.4GHz
* NVIDIA Geforce GT 540M
* 8Gb RAM
* 750Gb HD

Mi portátil equipa una tarjeta ''Nvidia Geforce GT540M'' que resulta pertenecer a una rama muerta en el árbol de desarrollo de Nvidia.

Esta tarjeta provocaba todo tipo de problemas de sobrecalientamiento, pero en las últimas versiones de Linux instalando el driver de Nvidia parece funcionar correctamente.

= Programas básicos =

== Linux Mint ==

Linux Mint incluye <code>sudo</code> <ref>ya no incluye gksu pero tampoco es imprescindible</ref> y las aplicaciones que uso habitualmente para gestión de paquetes por defecto (''aptitude'' y ''synaptic'').

Interesa tener instalado <code>sudo apt install ppa-purge</code>. Sirve para eliminar ppas junto con los programas instalados desde ese ppa.

Tampoco voy a enredar nada con los orígenes del software (de momento)

== Firmware ==

Ya no es necesario intalar los paquetes de ''microcode'' la instalación de Tricia se encargó de instalar:

* <code>amd64-microcode</code>
* <code>intel-microcode</code>

Instalamos el driver de nvidia recomendado, el ''Mint'' nos avisa de que tenemos que revisar la instalación de los drivers.

El driver de Nvidia viene muy mejorado. Merece la pena ver todas las opciones.

Una vez instalado el driver de nvidia, el comando <code>prime-select query</code>debe indicarnos la tarjeta activa y podremos cambiar de tarjeta ejecutando <code>prime-select [nvidia|intel]</code>

== Control de configuraciones con git ==

Una vez instalado el driver de nvidia y antes de seguir con la instalación instalamos el <code>git</code> y el <code>etckeeper</code> para que toda nuestra instalación quede reflejada en los repos.

=== Instalación de <code>etckeeper</code> ===

¡Ojo!, nos hacemos <code>root</code> para ejecutar:

<pre>sudo su -
git config --global user.email xxxxx@whatever.com
git config --global user.name &quot;Name Surname&quot;
apt install etckeeper</pre>
''etckeeper'' hara un control automático de tus ficheros de configuración en <code>/etc</code>

Para echar una mirada a los ''commits'' creados puedes ejecutar:

<pre>cd /etc
sudo git log</pre>
=== Controlar dotfiles con git ===

Vamos a crear un repo de git para controlar nuestros ficheros personales de configuración.

Creamos el repo donde queramos

<pre>mkdir usrcfg
cd usrcfg
git init
git config core.worktree &quot;/home/salvari&quot;</pre>
Y ya lo tenemos, un repo que tiene el directorio de trabajo apuntando a nuestro ''$HOME''.

Podemos añadir los ficheros de configuración que queramos al repo:

<pre>git add .bashrc
git commit -m &quot;Add some dotfiles&quot;</pre>
Una vez que tenga añadidos los ficheros que quiero tener controlados pondré <code>*</code> en el fichero <code>.git/info/exclude</code> de mi repo para que ignore todos los ficheros de mi <code>$HOME</code>.

Cuando instalo algún programa nuevo añado a mano los ficheros de configuración al repo.

== Parámetros de disco duro ==

Tengo un disco duro ssd y otro hdd normal.

El area de intercambio la hemos creado en el disco duro hdd, no se usará mucho pero evitamos multiples operaciones de escritura en el disco ssd en caso de que se empiece a tirar del swap.

Añadimos el parámetro <code>noatime</code> para las particiones de <code>root</code> y <code>/home</code>, que si que se han creado en el ssd.

<pre># /etc/fstab: static file system information.
#
# Use 'blkid' to print the universally unique identifier for a
# device; this may be used with UUID= as a more robust way to name devices
# that works even if disks are added and removed. See fstab(5).
#
# &lt;file system&gt; &lt;mount point&gt;   &lt;type&gt;  &lt;options&gt;       &lt;dump&gt;  &lt;pass&gt;
# / was on /dev/sda5 during installation
UUID=d96a5501-75b9-4a25-8ecb-c84cd4a3fff5 /               ext4    noatime,errors=remount-ro 0       1
# /home was on /dev/sda7 during installation
UUID=8fcde9c5-d694-4417-adc0-8dc229299f4c /home           ext4    defaults,noatime        0       2
# /store was on /dev/sdc7 during installation
UUID=0f0892e0-9183-48bd-aab4-9014dc1bd03a /store          ext4    defaults        0       2
# swap was on /dev/sda6 during installation
UUID=ce11ccb0-a67d-4e8b-9456-f49a52974160 none            swap    sw              0       0
# swap was on /dev/sdc5 during installation
UUID=11090d84-ce98-40e2-b7be-dce3f841d7b4 none            swap    sw              0       0</pre>
Una vez modificado el <code>/etc/fstab</code> no hace falta arrancar, basta con ejecutar lo siguiente:

<pre>mount -o remount /
mount -o remount /home
mount</pre>
=== Ajustar ''Firefox'' ===

Seguimos [https://easylinuxtipsproject.blogspot.com/p/ssd.html#ID10 esta referencia]

Visitamos <code>about::config</code> con el navegador.

Cambiamos

* <code>browser.cache.disk.enable</code> '''false'''
* <code>browser.cache.memory.enable</code> '''true'''
* <code>browser.cache.memory.capacity</code> '''204800'''
* <code>browser.sessionstore.interval</code> '''15000000'''

TODO: Comprobar ''trim'' en mi disco duro. Y mirar [https://easylinuxtipsproject.blogspot.com/p/speed-mint.html esto]

== Fuentes adicionales ==

Instalamos algunas fuentes desde los orígenes de software:

<pre>sudo apt install ttf-mscorefonts-installer
sudo apt install fonts-noto</pre>
Y la fuente [https://robey.lag.net/2010/06/21/mensch-font.html Mensch] la bajamos directamente al directorio <code>~/.local/share/fonts</code>

== Firewall ==

<code>ufw</code> y <code>gufw</code> vienen instalados por defecto, pero no activados.

<pre>aptitude install ufw
ufw default deny
ufw enable
ufw status verbose
aptitude install gufw</pre>

-----

<blockquote>'''Nota''': Ojo con el log de <code>ufw</code>, tampoco le sienta muy bien al ssd esa escritura masiva.
</blockquote>

-----

== Aplicaciones variadas ==

<blockquote>'''Nota''': Ya no instalamos ''menulibre'', Linux Mint tiene una utilidad de edición de menús.
</blockquote>
; Keepass2
: Para mantener nuestras contraseñas a buen recaudo
; Gnucash
: Programa de contabilidad, la versión de los repos está bastante atrasada habrá que probar la nueva.
; Deluge
: Programa de descarga de torrents (acuérdate de configurar tus cortafuegos)
; rsync, grsync
: Para hacer backups de nuestros ficheros
; Descompresores variados
: Para lidiar con los distintos formatos de ficheros comprimidos
; mc
: Midnight Comander, gestor de ficheros en modo texto
; most
: Un <code>less</code> mejorado

<pre>sudo apt install keepass2 gnucash deluge rsync grsync rar unrar \
zip unzip unace bzip2 lzop p7zip p7zip-full p7zip-rar chromium-browser\
most mc</pre>
; Chromium
: Como Chrome pero libre, ahora en Ubuntu solo está disponible como snap así que tendremos que dar un rodeo.

<pre class="{bash}">sudo add-apt-repository ppa:xalt7x/chromium-deb-vaapi
cat &lt;&lt;EOF | sudo tee /etc/apt/preferences.d/pin-xalt7x-chromium-deb-vaapi
Package: *
Pin: release o=LP-PPA-xalt7x-chromium-deb-vaapi
Pin-Priority: 1337
EOF

sudo apt update
sudo apt install chromium-browser chromium-codecs-ffmpeg</pre>
== Algunos programas de control ==

Son útiles para control de consumo.

<pre>sudo apt install tlp tlp-rdw htop powertop</pre>
== Programas de terminal ==

Dos imprescindibles:

<pre>sudo apt install guake terminator</pre>
'''TODO:''' asociar ''Guake'' a una combinación apropiada de teclas.

== Dropbox ==

Lo instalamos desde el software manager.

== Chrome ==

Instalado desde [https://www.google.com/chrome/ la página web de Chrome]

== Varias aplicaciones instaladas de binarios ==

Lo recomendable en un sistema POSIX es instalar los programas adicionales en <code>/usr/local</code> o en <code>/opt</code>. Yo soy más chapuzas y suelo instalar en <code>~/apt</code> por que el portátil es personal e intrasferible. En un ordenador compartido es mejor usar <code>/opt</code>.

=== Freeplane ===

Para hacer mapas mentales, presentaciones, resúmenes, apuntes… La versión incluida en LinuxMint está un poco anticuada.

# descargamos desde [http://freeplane.sourceforge.net/wiki/index.php/Home la web].
# Descomprimimos en <code>~/apps/freeplane</code>
# Creamos enlace simbólico
# Añadimos a los menús

=== Telegram Desktop ===

Cliente de Telegram, descargado desde la [https://desktop.telegram.org/ página web].

=== Tor browser ===

Descargamos desde la [https://www.torproject.org/ página oficial del proyecto] Descomprimimos en <code>~/apps/</code> y ejecutamos desde terminal:

<pre>cd ~/apps/tor-browser
./start-tor-browser.desktop --register-app</pre>
=== Brave browser ===

Instalamos siguiendo las instrucciones de la [https://brave-browser.readthedocs.io/en/latest/installing-brave.html#linux página web oficial]

<pre class="{bash}">curl -s https://brave-browser-apt-release.s3.brave.com/brave-core.asc | sudo apt-key --keyring /etc/apt/trusted.gpg.d/brave-browser-release.gpg add -

echo &quot;deb [arch=amd64] https://brave-browser-apt-release.s3.brave.com/ stable main&quot; | sudo tee /etc/apt/sources.list.d/brave-browser-release.list

sudo apt update

sudo apt install brave-browser</pre>
=== TiddlyDesktop ===

Descargamos desde la [https://github.com/Jermolene/TiddlyDesktop página web], descomprimimos y generamos la entrada en el menú.

=== Joplin ===

Una herramienta libre para mantener notas sincronizadas entre el móvil y el portátil.

La instalamos en el directorio <code>~/apps/joplin</code> descargando el AppImage desde la [https://joplinapp.org/ página web]

Como siempre nos creamos una entrada en el menú.

== Terminal y Shell ==

Por defecto tenemos instalado <code>bash</code>.

=== bash-git-promt ===

Seguimos las instrucciones de [https://github.com/magicmonty/bash-git-prompt este github]

=== zsh ===

Nos adelantamos a los acontecimientos, pero conviene tener instaladas las herramientas de entornos virtuales de python antes de instalar ''zsh'' con el plugin para ''virtualenvwrapper''.

<pre>apt install python-all-dev
apt install python3-all-dev
apt install python-pip python-virtualenv virtualenv python3-pip
apt install virtualenvwrapper</pre>
''zsh'' viene por defecto en mi instalación, en caso contrario:

<pre>apt install zsh</pre>
Para ''zsh'' vamos a usar [https://github.com/zsh-users/antigen antigen], así que nos lo clonamos en <code>~/apps/</code>

<pre>cd ~/apps
git clone https://github.com/zsh-users/antigen</pre>
También vamos a usar [https://github.com/olivierverdier/zsh-git-prompt zsh-git-prompt], así que lo clonamos también:

<pre>cd ~/apps
git clone https://github.com/olivierverdier/zsh-git-prompt)</pre>
Y editamos el fichero <code>~/.zshrc</code> para que contenga:

<pre># This line loads .profile, it's experimental
[[ -e ~/.profile ]] &amp;&amp; emulate sh -c 'source ~/.profile'

source ~/apps/zsh-git-prompt/zshrc.sh
source ~/apps/antigen/antigen.zsh

# Load the oh-my-zsh's library.
antigen use oh-my-zsh

# Bundles from the default repo (robbyrussell's oh-my-zsh).
antigen bundle git
antigen bundle command-not-found

# must install autojump for this
#antigen bundle autojump

# extracts every kind of compressed file
antigen bundle extract

# jump to dir used frequently
antigen bundle z

#antigen bundle pip

antigen bundle common-aliases

antigen bundle robbyrussell/oh-my-zsh plugins/virtualenvwrapper

antigen bundle zsh-users/zsh-completions

# Syntax highlighting bundle.
antigen bundle zsh-users/zsh-syntax-highlighting
antigen bundle zsh-users/zsh-history-substring-search ./zsh-history-substring-search.zsh

# Arialdo Martini git needs awesome terminal font
#antigen bundle arialdomartini/oh-my-git
#antigen theme arialdomartini/oh-my-git-themes oppa-lana-style

# autosuggestions
antigen bundle tarruda/zsh-autosuggestions

#antigen theme agnoster
antigen theme gnzh

# Tell antigen that you're done.
antigen apply

# Correct rm alias from common-alias bundle
unalias rm
alias rmi='rm -i'</pre>
Para usar ''virtualenvwrapper'' hay que decidir en que directorio queremos salvar los entornos virtuales. El obvio seria <code>~/.virtualenvs</code> la alternativa sería <code>~/.local/share/virtualenvs</code>.

El que escojamos lo tenemos que crear y añadirlo a nuestro <code>~/.profile</code> con las líneas:

<pre># WORKON_HOME for virtualenvwrapper
if [ -d &quot;$HOME/.local/share/virtualenvs&quot; ] ; then
    WORKON_HOME=&quot;$HOME/.local/share/virtualenvs&quot;
fi</pre>
''Antigen'' ya se encarga de descargar todos los plugins que queramos utilizar en zsh. Todos el software se descarga en <code>~/.antigen</code>

Para configurar el [https://github.com/olivierverdier/zsh-git-prompt zsh-git-prompt], que inspiró el bash-git-prompt, he modificado el fichero <code>zshrc.sh</code> de ''zsh-git-prompt'' y el fichero del tema ''gnzh'' en <code>~/.antigen/bundles/robbyrussell/oh-my-zsh/themes/gnzh.zsh-theme</code>

Después de seguir estos pasos basta con arrancar el ''zsh''

=== tmux ===

Esto no tiene mucho que ver con los shell, lo he instalado para aprender a usarlo.

<pre>sudo apt install tmux</pre>
[https://leanpub.com/the-tao-of-tmux/read El tao de tmux]


-----

<blockquote>'''Nota''': Instalar ''rxvt'' junto con tmux como terminal alternativo
</blockquote>

-----

== Utilidades ==

''Agave'' y ''pdftk'' ya no existen, nos pasamos a ''gpick'' y ''poppler-utils'':

Instalamos ''gpick'' con <code>sudo apt install gpick</code>

== Codecs ==

<pre>sudo apt-get install mint-meta-codecs</pre>
== Syncthing ==

Añadimos el ppa:

<pre class="{bash}">curl -s https://syncthing.net/release-key.txt | sudo apt-key add -

echo &quot;deb https://apt.syncthing.net/ syncthing stable&quot; | sudo tee /etc/apt/sources.list.d/syncthing.list


sudo apt-get update
sudo apt-get install syncthing</pre>
= Utilidades =

== htop ==

<pre>sudo apt install htop</pre>
== gparted ==

Instalamos ''gparted'' para poder formatear memorias usb

<code>sudo apt install gparted</code>

== wkhtmltopdf ==

<pre>sudo apt install wkhtmltopdf</pre>
= Internet =

= Rclone =

Instalamos desde la página web, siempre que te fies obviamente.

<pre>curl https://rclone.org/install.sh | sudo bash</pre>
== Recetas rclone ==

Copiar directorio local en la nube:

<pre>rclone copy /localdir hubic:backup -vv</pre>
Si queremos ver el directorio en la web de Hubic tenemos que copiarlo en ''default'':

<pre>rclone copy /localdir hubic:default/backup -vv</pre>
Sincronizar una carpeta remota en local:

<pre>rclone sync hubic:directorio_remoto /home/salvari/directorio_local -vv</pre>
== Referencias ==

* [https://elblogdelazaro.gitlab.io//articles/rclone-sincroniza-ficheros-en-la-nube/ Como usar rclone (blogdelazaro)]
* [https://elblogdelazaro.gitlab.io//articles/rclone-cifrado-de-ficheros-en-la-nube/ y con cifrado (blogdelazaro)]
* [https://rclone.org/docs/ Documentación]

= Documentación =

== Vanilla LaTeX ==

Para instalar la versión más reciente de LaTeX hay que aplicar este truco.

<pre>cd ~
mkdir tmp
cd tmp
wget http://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz
tar xzf install-tl-unx.tar.gz
cd install-tl-xxxxxx</pre>
La parte xxxxxx varía en función del estado de la última versión de LaTeX disponible.

<pre>sudo ./install-tl</pre>
Una vez lanzada la instalación podemos desmarcar las opciones que instalan la documentación y las fuentes. Eso nos obligará a consultar la documentación on line pero ahorrará practicamente el 50% del espacio necesario. En mi caso sin doc ni src ocupa 2,3Gb

<pre>mkdir -p /opt/texbin
sudo ln -s /usr/local/texlive/2020/bin/x86_64-linux/* /opt/texbin</pre>
Por último para acabar la instalación añadimos <code>/opt/texbin</code> al ''PATH''. Para ''bash'' y ''zsh'' basta con añadir al fichero <code>~/.profile</code> las siguientes lineas:

<pre># adds texlive to my PATH
if [ -d &quot;/opt/texbin&quot; ] ; then
    PATH=&quot;$PATH:/opt/texbin&quot;
fi</pre>
En cuanto a ''fish'' (si es que lo usas, claro) tendremos que modificar (o crear) el fichero <code>~/.config/fish/config.fish</code> y añadir la siguiente linea:

<pre>set PATH $PATH /opt/texbin</pre>
=== Falsificando paquetes ===

Ya tenemos el ''texlive'' instalado, ahora necesitamos que el gestor de paquetes sepa que ya lo tenemos instalado.

<pre>sudo apt install equivs --no-install-recommends
mkdir -p /tmp/tl-equivs &amp;&amp; cd /tmp/tl-equivs
equivs-control texlive-local</pre>
Alternativamente para hacerlo más fácil podemos descargarnos un fichero <code>texlive-local</code>ya preparado, ejecutando:

<pre>wget http://www.tug.org/texlive/files/debian-equivs-2018-ex.txt
/bin/cp -f debian-equivs-2020-ex.txt texlive-local</pre>
Editamos la versión (si queremos) y procedemos a generar el paquete ''deb''.

<pre>equivs-build texlive-local</pre>
El paquete que hemos generado tiene una dependencia: ''freeglut3'', hay que instalarla previamente.

<pre>sudo apt install freeglut3
sudo dpkg -i texlive-local_2020-1_all.deb</pre>
Todo listo, ahora podemos instalar cualquier paquete debian que dependa de ''texlive'' sin problemas de dependencias, aunque no hayamos instalado el ''texlive'' de Debian.

=== Fuentes ===

Para dejar disponibles las fuentes opentype y truetype que vienen con texlive para el resto de aplicaciones:

<pre>sudo cp $(kpsewhich -var-value TEXMFSYSVAR)/fonts/conf/texlive-fontconfig.conf /etc/fonts/conf.d/09-texlive.conf
sudo nano /etc/fonts/conf.d/09-texlive.conf</pre>
Borramos la linea:

<pre>&lt;dir&gt;/usr/local/texlive/20xx/texmf-dist/fonts/type1&lt;/dir&gt;</pre>
Y ejecutamos:

<pre>sudo fc-cache -fsv</pre>
Actualizaciones Para actualizar nuestro ''latex'' a la última versión de todos los paquetes:

<pre>sudo /opt/texbin/tlmgr update --self
sudo /opt/texbin/tlmgr update --all</pre>
También podemos lanzar el instalador gráfico con:

<pre>sudo /opt/texbin/tlmgr --gui</pre>
Para usar el instalador gráfico hay que instalar previamente:

<pre>sudo apt-get install perl-tk --no-install-recommends</pre>
Lanzador para el actualizador de ''texlive'':

<pre>mkdir -p ~/.local/share/applications
/bin/rm ~/.local/share/applications/tlmgr.desktop
cat &gt; ~/.local/share/applications/tlmgr.desktop &lt;&lt; EOF
[Desktop Entry]
Version=1.0
Name=TeX Live Manager
Comment=Manage TeX Live packages
GenericName=Package Manager
Exec=gksu -d -S -D &quot;TeX Live Manager&quot; '/opt/texbin/tlmgr -gui'
Terminal=false
Type=Application
Icon=system-software-update
EOF</pre>
== Tipos de letra ==

Creamos el directorio de usuario para tipos de letra:

<pre>mkdir ~/.local/share/fonts</pre>
== Fuentes Adicionales ==

Me he descargado de internet la fuente [https://robey.lag.net/downloads/mensch.ttf Mensch] el directorio de usuario para los tipos de letra: <code>~/.local/share/fonts</code>

Además he clonado el repo [https://github.com/ProgrammingFonts/ProgrammingFonts ''Programming Fonts''] y enlazado algunas fuentes (Hack y Menlo)

<pre>cd ~/wherever
git clone https://github.com/ProgrammingFonts/ProgrammingFonts
cd ~/.local/share/fonts
ln -s ~/wherever/ProgrammingFonts/Hack .
ln -s ~/wherever/ProgrammingFonts/Menlo .</pre>
== Pandoc ==

''Pandoc'' es un traductor entre formatos de documento. Está escrito en Python y es increiblemente útil. De hecho este documento está escrito con ''Pandoc''.

Instalado el ''Pandoc'' descargando paquete deb desde [http://pandoc.org/installing.html la página web del proyecto].

Además descargamos plantillas adicionales desde [https://github.com/jgm/pandoc-templates este repo] ejecutando los siguientes comandos:

<pre>mkdir ~/.pandoc
cd ~/.pandoc
git clone https://github.com/jgm/pandoc-templates templates</pre>
== Calibre ==

La mejor utilidad para gestionar tu colección de libros electrónicos.

Ejecutamos lo que manda la página web:

<pre>sudo -v &amp;&amp; wget -nv -O- https://raw.githubusercontent.com/kovidgoyal/calibre/master/setup/linux-installer.py \
| sudo python -c &quot;import sys; main=lambda:sys.stderr.write('Download failed\n'); exec(sys.stdin.read()); main()&quot;</pre>
Para usar el calibre con el Kobo Glo:

* Desactivamos todos los plugin de Kobo menos el Kobo Touch Extended
* Creamos una columna MyShelves con identificativo #myshelves
* En las opciones del plugin:
** En la opción Collection columns añadimos las columnas series,#myshelves
** Marcamos las opciones Create collections y Delete empy collections
** Marcamos ''Modify CSS''
** Update metadata on device y Set series information

Algunos enlaces útiles:

* (https://github.com/jgoguen/calibre-kobo-driver)
* (http://www.lectoreselectronicos.com/foro/showthread.php?15116-Manual-de-instalaci%C3%B3n-y-uso-del-plugin-Kobo-Touch-Extended-para-Calibre)
* (http://www.redelijkheid.com/blog/2013/7/25/kobo-glo-ebook-library-management-with-calibre)
* (https://www.netogram.com/kobo.htm)

== Scribus ==

Scribus es un programa libre de composición de documentos. con Scribus puedes elaborar desde los folletos de una exposición hasta una revista o un poster.

Para tener una versión más actualizada instalamos:

<pre>sudo add-apt-repository ppa:scribus/ppa
sudo apt update
sudo apt install scribus scribus-ng scribus-template scribus-ng-doc</pre>
=== Cambiados algunos valores por defecto ===

He cambiado los siguientes valores en las dos versiones, non están exactamente en el mismo menú pero no son díficiles de encontrar:

* Lenguaje por defecto: '''English'''
* Tamaño de documento: '''A4'''
* Unidades por defecto: '''milimeters'''
* Show Page Grid: '''Activado'''
* Dimensiones de la rejilla:
** Mayor: '''30 mm'''
** Menor: '''6mm'''
* En opciones de salida de ''pdf'' indicamos que queremos salida a impresora y no a pantalla. Y también que no queremos ''spot colors'', que serían sólo para ciertas impresoras industriales, así que activamos la opción ''Convert Spot Colors to Process Colors''.

Siempre se puede volver a los valores por defecto sin mucho problema (hay una opción para ello)

Referencia [https://www.youtube.com/watch?v=3sEoYZGABQM&list=PL3kOqLpV3a67b13TY3WxYVzErYUOLYekI aquí]

=== Solucionados problemas de ''hyphenation'' ===

''Scribus'' no hacia correctamente la separación silábica en castellano, he instalado los paquetes:

* hyphen-es
* hyphen-gl

Y ahora funciona correctamente.

== Foliate: lector de libros electrónicos ==

Instalado el paquete deb desde [https://github.com/johnfactotum/foliate/releases su propio github]

= Desarrollo software =

== Paquetes esenciales ==

Estos son los paquetes esenciales para empezar a desarrollar software en Linux.

<pre>sudo apt install build-essential checkinstall make automake cmake autoconf \
git git-core git-crypt dpkg wget</pre>
== Git ==


-----

'''NOTA''': Si quieres instalar la última versión de git, los git developers tienen un ppa para ubuntu, si quieres tener el git más actualizado:

<pre class="{bash}">sudo add-apt-repository ppa:git-core/ppa
sudo apt update
sudo apt upgrade</pre>

-----

Control de versiones distribuido. Imprescindible. Para ''Linux Mint'' viene instalado por defecto.

Configuración básica de git:

<pre>git config --global ui.color auto
git config --global user.name &quot;Pepito Pérez&quot;
git config --global user.email &quot;pperez@mikasa.com&quot;

git config --global alias.cl clone

git config --global alias.st &quot;status -sb&quot;
git config --global alias.last &quot;log -1 --stat&quot;
git config --global alias.lg &quot;log --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %Cblue&lt;%an&gt;%Creset' --abbrev-commit --date=relative --all&quot;
git config --global alias.dc &quot;diff --cached&quot;

git config --global alias.unstage &quot;reset HEAD --&quot;

git config --global alias.ci commit
git config --global alias.ca &quot;commit -a&quot;

git config --global alias.ri &quot;rebase -i&quot;
git config --global alias.ria &quot;rebase -i --autosquash&quot;
git config --global alias.fix &quot;commit --fixup&quot;
git config --global alias.squ &quot;commit --squash&quot;

git config --global alias.cp cherry-pick
git config --global alias.co checkout
git config --global alias.br branch
git config --global core.editor emacs</pre>
== Emacs ==

Instalado emacs desde los repos:

<pre>sudo aptitude install emacs</pre>
== Lenguaje de programación D (D programming language) ==

El lenguaje de programación D es un lenguaje de programación de sistemas con una sintaxis similar a la de C y con tipado estático. Combina eficiencia, control y potencia de modelado con seguridad y productividad.

=== D-apt e instalación de programas ===

Configurado ''d-apt'', instalados todos los programas incluidos

<pre>sudo wget http://master.dl.sourceforge.net/project/d-apt/files/d-apt.list -O /etc/apt/sources.list.d/d-apt.list
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys  EBCF975E5BA24D5E
sudo apt update</pre>
Instalamos todos los programas asociados excepto ''textadept'' que no uso.

<pre>sudo apt install dmd-compiler dmd-tools dub dcd dfix dfmt dscanner</pre>
=== DCD ===

Una vez instalado el DCD tenemos que configurarlo creando el fichero <code>~/.config/dcd/dcd.conf</code> con el siguiente contenido:

<pre>/usr/include/dmd/druntime/import
/usr/include/dmd/phobos</pre>
Podemos probarlo con:

<pre>dcd-server &amp;
echo | dcd-client --search toImpl</pre>
=== gdc ===

Instalado con:

<pre>sudo aptitude install gdc</pre>
=== ldc ===

Instalado con:

<pre>sudo aptitude install ldc</pre>
Para poder ejecutar aplicaciones basadas en Vibed, necesitamos instalar:

<pre>sudo apt-get install -y libssl-dev libevent-dev</pre>
=== Emacs para editar D ===

Instalados los siguientes paquetes desde Melpa

* d-mode
* flymake-d
* flycheck
* flycheck-dmd-dub
* flychek-d-unittest
* auto-complete (desde melpa)
* ac-dcd

Referencias * (https://github.com/atilaneves/ac-dcd) * (https://github.com/Hackerpilot/DCD)

== C, C++ ==

=== Instalación de Gnu Global ===

Para instalar las dependencias, previamente instalamos:

<pre class="{shell}">sudo apt install ncurses-dev id-utils exuberant-ctags python-pygments</pre>
Con <code>ctags --version</code> nos aseguramos de que se llama a Exuberant y no el ctags que instala Emacs. Si no es así habrá que revisar la definición del <code>PATH</code>

<code>python-pygments</code> no es necesario para C o C++, pero añade funcionalidad a Global (hasta 25 lenguajes de programación más)

No podemos instalar Global desde los repos de Ubuntu, está muy anticuado y genera bases de datos enormes y lentas. Tendremos que compilarlo.

Nos bajamos las fuentes del programa desde [https://www.gnu.org/software/global/ la página oficial] En el momento de escribir esto se trata de la versión 6.6.4.

Descomprimimos los fuentes y los compilamos con:

<pre class="{shell}">./configure --prefix=/usr/local --with-exuberant-ctags=/usr/bin/ctags
make
sudo make install</pre>
He comprobado que make uninstall funciona correctamente, las librerías quedan instaladas en <code>/usr/local/lib/gtags</code> y los ejecutables en <code>/usr/local/bin</code>

== Processing ==

Bajamos los paquetes de las respectivas páginas web, descomprimimimos en <code>~/apps/</code>, en las nuevas versiones incorpora un script de instalación que ya se encarga de crear el fichero ''desktop''.

La última versión incorpora varios modos de trabajo, he descargado el modo ''Python'' para probarlo.

== openFrameworks ==

Nos bajamos los fuentes para linux 64bits desde [https://openframeworks.cc la página web del proyecto], y las descomprimimos en un directorio para proceder a compilarlas.

No hay más que seguir [https://openframeworks.cc/setup/linux-install/ las instrucciones de instalación para linux].

La instalación no es demasiado intrusiva si tienes Ubuntu 18 o mayor y una versión reciente del gcc.

En la primera pregunta que nos hace es necesario contestar que no. De lo contrario falla la compilación.

Añade los siguientes paquetes a nuestro sistema

<pre class="{bash}">installing OF dependencies
OF needs to install the following packages using apt-get:
curl libjack-jackd2-0 libjack-jackd2-dev freeglut3-dev libasound2-dev libxmu-dev libxxf86vm-dev g++ libgl1-mesa-dev libglu1-mesa-dev libraw1394-dev libudev-dev libdrm-dev libglew-dev libopenal-dev libsndfile-dev libfreeimage-dev libcairo2-dev libfreetype6-dev libssl-dev libpulse-dev libusb-1.0-0-dev libgtk-3-dev libopencv-dev libassimp-dev librtaudio-dev libboost-filesystem-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-libav gstreamer1.0-pulseaudio gstreamer1.0-x gstreamer1.0-plugins-bad gstreamer1.0-alsa gstreamer1.0-plugins-base gstreamer1.0-plugins-good gdb libglfw3-dev liburiparser-dev libcurl4-openssl-dev libpugixml-dev libgconf-2-4 libgtk2.0-0 libpoco-dev
Do you want to continue? [Y/n]</pre>
No te olvides de compilar también el ''Project Generator''.

== Python ==

De partida tenemos instalado dos versiones: ''python'' y ''python3''

<pre class="{bash}">python -V
Python 2.7.12

python3 -V
Python 3.5.2</pre>
=== Paquetes de desarrollo ===

Para que no haya problemas a la hora de instalar paquetes en el futuro conviene que instalemos los paquetes de desarrollo:

<pre>sudo apt install python-dev
sudo apt install python3-dev</pre>
=== pip, virtualenv, virtualenvwrapper, virtualfish ===

Los he instalado a nivel de sistema.

''pip'' es un gestor de paquetes para '''Python''' que facilita la instalación de librerías y utilidades.

Para poder usar los entornos virtuales instalaremos también ''virtualenv''.

Instalamos los dos desde aptitude:

<pre class="{bash}">sudo apt install python-pip python-virtualenv virtualenv python3-pip</pre>
''virtualenv'' es una herramienta imprescindible en Python, pero da un poco de trabajo, así que se han desarrollado algunos frontends para simplificar su uso, para ''bash'' y ''zsh'' usaremos ''virtualenvwrapper'', y para ''fish'' el ''virtualfish''. Como veremos son todos muy parecidos.

Instalamos el virtualwrapper:

<pre class="{bash}">sudo apt install virtualenvwrapper -y</pre>
Para usar ''virtualenvwrapper'' tenemos que hacer:

<pre class="{bash}">source /usr/share/virtualenvwrapper/virtualenvwrapper.sh</pre>
O añadir esa linea a nuestros ficheros ''.bashrc'' y/o ''.zshrc''

Definimos la variable de entorno ''WORKON_HOME'' para que apunte al directorio por defecto, <code>~/.local/share/virtualenvs</code>. En ese directorio es donde se guardarán nuestros entornos virtuales.

En el fichero <code>.profile</code> añadimos:

<pre># WORKON_HOME for virtualenvwrapper
if [ -d &quot;$HOME/.local/share/virtualenvs&quot; ] ; then
    WORKON_HOME=&quot;$HOME/.local/share/virtualenvs&quot;
fi</pre>
[http://virtualenvwrapper.readthedocs.io/en/latest/command_ref.html Aquí] tenemos la referencia de comandos de ''virtualenvwrapper''

Por último, si queremos tener utilidades parecidas en nuestro ''fish shell'' instalamos ''virtualfish'':

<pre class="{bash}">sudo pip install virtualfish</pre>
[http://virtualfish.readthedocs.io/en/latest/index.html Aquí] tenemos la documentación de ''virtualfish'' y la descripción de todos los comandos y plugins disponibles.

=== pipenv ===

No lo he instalado, pero en caso de instalación mejor lo instalamos a nivel de usuario con:

<pre class="{bash}">pip install --user pipenv</pre>
=== Instalación del Python 3.8 (última disponible) ===

Ejecutamos:

<pre class="{bash}">sudo apt install python3.8 python3.8-dev python3.8-venv</pre>
=== Instalación de bpython y ptpython ===

[https://bpython-interpreter.org/ ''bpython''] instalado desde repos <code>sudo apt install bpython bpython3</code>

[https://github.com/prompt-toolkit/ptpython ''ptpython''] instalado en un virtualenv para probarlo

=== Emacs para programar python ===

==== elpy: Emacs Python Development Enviroment ====

Para instalar <code>elpy</code> necesitamos intalar previamente ''venv'' el nuevo gestor de ''virtualenvs'' en Python 3.:

<pre>sudo apt install python3-venv</pre>
En el fichero <code>~/.emacs</code> necesitamos activar el módulo ''elpy'':

<pre class="{lisp}">;;----------------------------------------------------------------------
;; elpy
(elpy-enable)</pre>
En cuanto activemos ''elpy'' tendremos autocompletado del código y errores sintácticos. Merece la pena leerse toda la [https://elpy.readthedocs.io/en/latest/ documentación]

==== Flycheck ====

Para tener análisis sintáctico en tiempo real mientras estamos programando:

Añadimos a nuestro fichero <code>~/.emacs</code>:

<pre>;; Enable Flycheck

(when (require 'flycheck nil t)

  (setq elpy-modules (delq 'elpy-module-flymake elpy-modules))

  (add-hook 'elpy-mode-hook 'flycheck-mode))</pre>
==== Formateado ====

Usando ''autopep8'' o ''black'' tendremos autoformateado del código como paso previo a salvar el mismo en disco. (Yo aún no he probado ''black'')

<pre># and autopep8 for automatic PEP8 formatting
sudo apt install python-autopep8
# and yapf for code formatting (innecesario)
# sudo apt install yapf yapf3</pre>
Y añadimos la sección siguiente a nuestro fichero <code>~/.emacs</code>

<pre class="{lisp}">;; Enable autopep8

(require 'py-autopep8)

(add-hook 'elpy-mode-hook 'py-autopep8-enable-on-save)</pre>
==== jedi ====

Jedi le da ciertos superpoderes al autocompletado visualizando la documentación de cada propuesta de autocompletado.

Instalamos previamente:

<pre class="{bash}">sudo apt install python-jedi python3-jedi
# flake8 for code checks
sudo apt install flake8 python-flake8 python3-flake8</pre>
Y añadimos la sección en el fichero <code>~/.emacs</code>:

<pre class="{lisp}">;;----------------------------------------------------------------------
;; elpy
(elpy-enable)
(setq elpy-rpc-backend &quot;jedi&quot;)

(add-hook 'python-mode-hook 'jedi:setup)
(setq jedi:complete-on-dot t)</pre>
Desde ''Emacs'' ejecutamos: <code>alt-x jedi:install-server</code>

=== Jupyter ===

Una instalación para pruebas.

<pre>mkvirtualenv -p /usr/bin/python3 jupyter
python -m pip install jupyter</pre>
== neovim ==

Vamos a probar ''neovim'':

<pre>sudo apt-add-repository ppa:neovim-ppa/stable
sudo apt update
sudo apt install neovim</pre>
Para instalar los módulos de python creamos un ''virtualev'' que más tarde añadiremos al fichero <code>init.vim</code>.

<pre>mkvirtualenv -p /usr/bin/python3 neovim3
sudo pip install --upgrade neovim
deactivate</pre>
Revisar [https://neovim.io/doc/user/provider.html#provider-python esto]

{|
| '''NOTA''': El siguiente paso ya no parece necesario, las alternativas
|-
| se han actualizado con la instalación del ''neovim''.
|}

Para actualizar las alternativas:

<pre>sudo update-alternatives --install /usr/bin/vi vi /usr/bin/nvim 60
sudo update-alternatives --config vi
sudo update-alternatives --install /usr/bin/vim vim /usr/bin/nvim 60
sudo update-alternatives --config vim</pre>
==== Install ''vim-plug'' ====

Ejecutamos:

<pre>curl -fLo ~/.local/share/nvim/site/autoload/plug.vim --create-dirs \
    https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim</pre>
Configuramos el fichero de configuración de ''nvim'' (<code>~/.config/nvim/init.vim</code>):

<pre>&quot; Specify a directory for plugins
&quot; - For Neovim: ~/.local/share/nvim/plugged
&quot; - Avoid using standard Vim directory names like 'plugin'
call plug#begin('~/.local/share/nvim/plugged')

if has('nvim')
  Plug 'Shougo/deoplete.nvim', { 'do': ':UpdateRemotePlugins' }
else
  Plug 'Shougo/deoplete.nvim'
  Plug 'roxma/nvim-yarp'
  Plug 'roxma/vim-hug-neovim-rpc'
endif

Plug 'deoplete-plugins/deoplete-jedi'

&quot; Initialize plugin system
call plug#end()

let g:deoplete#enable_at_startup = 1

&quot; set python enviroments
let g:python_host_prog = '/full/path/to/neovim2/bin/python'
let g:python3_host_prog = '/home/salvari/.virtualenvs/neovim3/bin/python'

</pre>
La primera vez que abramos ''nvim'' tenemos que instalar los plugin porn comando ejecutando: <code>:PlugInstall</code>

'''Instalación de <code>dein</code>'''

{|
| '''Nota''':
|-
| Solo hay que instalar uno de los dos o ''dein'' o ''plug-vim''. Yo uso
|-
| ''plug-vim'' así que esto es sólo una referencia.
|}

https://github.com/Shougo/dein.vim

<pre>&quot; Add the dein installation directory into runtimepath
set runtimepath+=~/.config/nvim/dein/repos/github.com/Shougo/dein.vim

if dein#load_state('~/.config/nvim/dein')
  call dein#begin('~/.config/nvim/dein')

  call dein#add('~/.config/nvim/dein/repos/github.com/Shougo/dein.vim')
  call dein#add('Shougo/deoplete.nvim')
  call dein#add('Shougo/denite.nvim')
  if !has('nvim')
    call dein#add('roxma/nvim-yarp')
    call dein#add('roxma/vim-hug-neovim-rpc')
  endif

  call dein#end()
  call dein#save_state()
endif

filetype plugin indent on
syntax enable</pre>
== Firefox developer edition ==

El rollo de siempre, descargar desde [https://www.mozilla.org/en-US/firefox/developer/ la página web] descomprimir en <code>~/apps</code> y crear un lanzador.

== Navegadores cli ==

Herramientas útiles para depuración web

<pre class="{bash}">sudo apt install httpie links</pre>
== MariaDB ==

Instalamos la última estable para Ubuntu Bionic desde los repos oficiales.

Primero añadimos los reports

Añadimos la clave de firma:

<pre class="{bash}">sudo apt-get install software-properties-common
sudo apt-key adv --fetch-keys 'https://mariadb.org/mariadb_release_signing_key.asc'</pre>
Ahora tenemos dos opciones:

Podemos ejecutar:

<pre>sudo add-apt-repository 'deb [arch=amd64,arm64,ppc64el] http://ftp.icm.edu.pl/pub/unix/database/mariadb/repo/10.4/ubuntu bionic main'</pre>
O podemos crear un fichero <code>/etc/apt/apt.sources.list.d/MariaDB</code> con el siguiente contenido (yo dejo las fuentes comentadas):

<pre># MariaDB 10.4 repository list - created 2020-01-26 10:37 UTC
# http://downloads.mariadb.org/mariadb/repositories/
deb [arch=amd64,arm64,ppc64el] http://ftp.ubuntu-tw.org/mirror/mariadb/repo/10.4/ubuntu bionic main
# deb-src http://ftp.ubuntu-tw.org/mirror/mariadb/repo/10.4/ubuntu bionic main</pre>
Y ya solo nos queda lo de siempre:

<pre>sudo apt update
sudo apt upgrade
sudo apt install mariadb-server</pre>
Podemos comprobar con <code>systemctl status mariadb</code>

También podemos hacer login con el usuario <code>root</code>:

<pre>sudo mariadb -u root</pre>
Y ahora aseguramos la instación con:

<pre>sudo mysql_secure_installation</pre>
Yo diría que tienes que decir que si a todas las preguntas, excepto quizás al ''unix_socket_authentication''.

Por último sólo nos queda decidir si el servicio mariadb debe estar ejecutándose permanentemente o no.

Si queremos pararlo y que no se arranque automáticamente al arrancar el ordenador:

<pre>sudo systemctl stop mariadb
sudo systemctl disable mariadb</pre>
== Squirrel SQL Client ==

Bajamos el zip de estándar desde [http://www.squirrelsql.org/ la página web de Squirrel] (yo prefiero no usar el instalador)

Como de costumbre descomprimimos en <code>~/apps</code> y creamos una entrada en nuestro menú de aplicaciones.

Nos descargamos también el ''java connector'' para MariaDB. Desde la página oficial. Nos interesa el fichero <code>maria-java-client-2.6.0.jar</code>

Configuramos el driver para que sepa donde está el fichero <code>.jar</code> y ya estamos listos para trabajar.

== R y R-studio ==

Primero instalamos la última versión de R en nuestro pc:

<pre class="{bash}">sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys E298A3A825C0D65DFD57CBB651716619E084DAB9
sudo add-apt-repository 'deb https://cloud.r-project.org/bin/linux/ubuntu bionic-cran35/'
sudo apt install r-base</pre>
=== R-studio ===

Descargamos la última versión disponible de ''R-studio'' desde la [https://cloud.r-project.org/bin/linux/ubuntu página web]

Instalamos con ''gdebi'' (basta con clicar sobre el fichero ''.deb'')

== Octave ==

Instalado desde flatpak

<pre>sudo flatpak install flathub org.octave.Octave</pre>
= Desarrollo hardware =

== Arduino IDE ==

Bajamos los paquetes de la página [https://www.arduino.cc web], descomprimimimos en ''~/apps/arduino''.

La distribución del IDE incluye ahora un fichero <code>install.sh</code>que se encarga de hacer la integración del IDE en los menús de Linux.

Además también incluye un script (<code>arduino-linux-setup.sh</code>) para crear las ''devrules'' y que además desinstala el driver ''modemmanager'' y crea grupos nuevos en el sistema si no existen.

No tengo claro lo de desinstalar el driver así que creamos las ''devrules'' a mano mirando por el fichero.

Hay que añadir nuestro usuario a los grupos ''tty'', ''dialout'', ''uucp'' y ''plugdev'' (no hay que crear grupos nuevos, ya tenemos todos en el sistema)

<pre>sudo gpasswd --add &lt;usrname&gt; tty
sudo gpasswd --add &lt;usrname&gt; dialout
sudo gpasswd --add &lt;usrname&gt; uucp
sudo gpasswd --add &lt;usrname&gt; plugdev</pre>
Creamos los siguientes ficheros en el directorio <code>/etc/udev/rules.d</code>

Fichero <code>90-extraacl.rules</code> mete mi usario en el fichero de reglas (¬_¬)

<pre># Setting serial port rules

KERNEL==&quot;ttyUSB[0-9]*&quot;, TAG+=&quot;udev-acl&quot;, TAG+=&quot;uaccess&quot;, OWNER=&quot;salvari&quot;
KERNEL==&quot;ttyACM[0-9]*&quot;, TAG+=&quot;udev-acl&quot;, TAG+=&quot;uaccess&quot;, OWNER=&quot;salvari&quot;</pre>
Fichero <code>98-openocd.rules</code>

<pre># Adding Arduino M0/M0 Pro, Primo UDEV Rules for CMSIS-DAP port

ACTION!=&quot;add|change&quot;, GOTO=&quot;openocd_rules_end&quot;
SUBSYSTEM!=&quot;usb|tty|hidraw&quot;, GOTO=&quot;openocd_rules_end&quot;

#Please keep this list sorted by VID:PID

#CMSIS-DAP compatible adapters
ATTRS{product}==&quot;*CMSIS-DAP*&quot;, MODE=&quot;664&quot;, GROUP=&quot;plugdev&quot;

LABEL=&quot;openocd_rules_end&quot;</pre>
Fichero <code>avrisp.rules</code>

<pre># Adding AVRisp UDEV rules

SUBSYSTEM!=&quot;usb_device&quot;, ACTION!=&quot;add&quot;, GOTO=&quot;avrisp_end&quot;
# Atmel Corp. JTAG ICE mkII
ATTR{idVendor}==&quot;03eb&quot;, ATTRS{idProduct}==&quot;2103&quot;, MODE=&quot;660&quot;, GROUP=&quot;dialout&quot;
# Atmel Corp. AVRISP mkII
ATTR{idVendor}==&quot;03eb&quot;, ATTRS{idProduct}==&quot;2104&quot;, MODE=&quot;660&quot;, GROUP=&quot;dialout&quot;
# Atmel Corp. Dragon
ATTR{idVendor}==&quot;03eb&quot;, ATTRS{idProduct}==&quot;2107&quot;, MODE=&quot;660&quot;, GROUP=&quot;dialout&quot;

LABEL=&quot;avrisp_end&quot;</pre>
Fichero <code>40-defuse.rules</code>:

<pre># Adding STM32 bootloader mode UDEV rules

# Example udev rules (usually placed in /etc/udev/rules.d)
# Makes STM32 DfuSe device writeable for the &quot;plugdev&quot; group

ACTION==&quot;add&quot;, SUBSYSTEM==&quot;usb&quot;, ATTRS{idVendor}==&quot;0483&quot;, ATTRS{idProduct}==&quot;df11&quot;, MODE=&quot;664&quot;, GROUP=&quot;plugdev&quot;, TAG+=&quot;uaccess&quot;</pre>
Fichero <code>99-arduino-101.rules</code>:

<pre># Arduino 101 in DFU Mode

SUBSYSTEM==&quot;tty&quot;, ENV{ID_REVISION}==&quot;8087&quot;, ENV{ID_MODEL_ID}==&quot;0ab6&quot;, MODE=&quot;0666&quot;, ENV{ID_MM_DEVICE_IGNORE}=&quot;1&quot;, ENV{ID_MM_CANDIDATE}=&quot;0&quot;
SUBSYSTEM==&quot;usb&quot;, ATTR{idVendor}==&quot;8087&quot;, ATTR{idProduct}==&quot;0aba&quot;, MODE=&quot;0666&quot;, ENV{ID_MM_DEVICE_IGNORE}=&quot;1&quot;</pre>
Yo añado el fichero <code>99-arduino.rules</code> que se encarga de inhibir el modemmanager para que no capture al ''CircuitPlayground Express'':

<pre># for arduino brand, stop ModemManager grabbing port
ATTRS{idVendor}==&quot;2a03&quot;, ENV{ID_MM_DEVICE_IGNORE}=&quot;1&quot;
# for sparkfun brand, stop ModemManager grabbing port
ATTRS{idVendor}==&quot;1b4f&quot;, ENV{ID_MM_DEVICE_IGNORE}=&quot;1&quot;</pre>
=== Añadir soporte para ''Feather M0'' ===

Arrancamos el IDE Arduino y en la opción de ''Preferences::Aditional Boar Managers URLs'' añadimos la dirección <code>https://adafruit.github.io/arduino-board-index/package_adafruit_index.json</code>, si tenemos otras URL, simplemente añadimos esta separada por una coma.

Ahora desde el ''Board Manager'' instalamos:

* Arduino SAMD Boards
* Adafruit SAMD Boards

=== Añadir soporte para ''Circuit Playground Express'' ===

Bastaría con instalar ''Arduino SAMD Boards''

=== Añadir soporte para STM32 ===

Tenemos varias URL posibles para configurar en las preferencias del IDE Arduino:

* http://dan.drown.org/stm32duino/package_STM32duino_index.json (recomendada por Tutoelectro)
* https://github.com/stm32duino/BoardManagerFiles/raw/master/STM32/package_stm_index.json (parece la oficial, y tiene mejor pinta)

=== Añadir soporte para ESP32 ===

=== Añadir biblioteca de soporte para Makeblock ===


-----

'''Nota''': Pendiente de instalar


-----

Clonamos el [https://github.com/Makeblock-official/Makeblock-Libraries repo oficial en github].

Una vez que descarguemos las librerias es necesario copiar el directorio <code>Makeblock-Libraries/makeblock</code> en nuestro directorio de bibliotecas de Arduino. En mi caso <code>~/Arduino/libraries/</code>.

Una vez instaladas las bibliotecas es necesario reiniciar el IDE Arduino si estaba arrancado. Podemos ver si se ha instalado correctamente simplemente echando un ojo al menú de ejemplos en el IDE, tendríamos que ver los ejemplos de ''Makeblock''.

Un detalle importante para programar el Auriga-Me es necesario seleccionar el micro Arduino Mega 2560 en el IDE Arduino.

== Pinguino IDE ==


-----

'''Nota''': Pendiente de instalar


-----

Tenemos el paquete de instalación disponible en su página [http://pinguino.cc/download.php web]

Ejecutamos el programa de instalación. El programa descargará los paquetes Debian necesarios para dejar el IDE y los compiladores instalados.

Al acabar la instalación he tenido que crear el directorio ''~/Pinguino/v11'', parece que hay algún problema con el programa de instalación y no lo crea automáticamente.

El programa queda correctamente instalado en ''/opt'' y arranca correctamente, habrá que probarlo con los micros.

== esp-idf ==

Instalamos las dependencias (cmake ya lo tenemos instalado)


-----

'''NOTA''': No es necesario instalar los paquetes de python que nos especifican en las instrucciones de instalación del ''esp-idf'', se instalarán automáticamente en el siguiente paso.


-----

<pre class="{bash}">sudo apt-get install gperf  cmake ninja-build ccache libffi-dev libssl-dev</pre>
Ahora creamos un directorio para nuestro ''tool-chain'':

<pre class="{bash}">mkdir ~/esp
cd ~/esp
git clone --recursive https://github.com/espressif/esp-idf</pre>
También es necesario que nuestro usuario pertenezca al grupo <code>dialout</code>, pero eso ya deberíamos tenerlo hecho de antes.

Una vez clonado el repo ejecutamos el script de instalación

<pre class="{bash}">cd ~/esp/esp-idf
./install.sh</pre>
Este script nos va a dejar instaladas todas las herramientas necesarias en el directorio <code>~/.expressif</code>

Para empezar a trabajar bastará con hacer un ''source'' del fichero <code>~/esp/esp-idf/export.sh</code>:

<pre class="{bash}">. ~/esp/esp-idf/export.sh</pre>
== KiCAD ==

En la [http://kicad-pcb.org/download/linux-mint/ página web del proyecto] nos recomiendan el ppa a usar para instalar la última versión estable:

<pre>sudo add-apt-repository --yes ppa:js-reynaud/kicad-5
sudo apt-get update
sudo apt-get install kicad
sudo apt install kicad-footprints kicad-libraries kicad-packages3d kicad-symbols kicad-templates</pre>
Paciencia, el paquete <code>kicad-packages3d</code> tarda un buen rato en descargarse.

Algunas librerías alternativas:

* [https://github.com/freetronics/freetronics_kicad_library Freetronics] una libreria que no solo incluye Shield para Arduino sino una completa colección de componentes que nos permitirá hacer proyectos completos. [http://www.freetronics.com Freetronics] es una especie de BricoGeek australiano, publica tutoriales, vende componentes, y al parecer mantiene una biblioteca para KiCAD. La biblioteca de Freetronics se mantiene en un repo de github. Lo suyo es incorporarla a cada proyecto, por que si la actualizas se pueden romper los proyectos que estes haciendo.
* [http://meta-blog.eklablog.com/kicad-librairie-arduino-pretty-p930786 eklablog] Esta biblioteca de componentes está incluida en el github de KiCAD, así que teoricamente no habría que instalarla en nuestro disco duro.

== Analizador lógico ==

Mi analizador es un OpenBench de Seedstudio, [http://dangerousprototypes.com/docs/Open_Bench_Logic_Sniffer aquí hay mas info]

=== Sigrok ===

Instalamos '''Sigrok''', simplemente desde los repos de Debian:

<pre class="{bash}">sudo aptitude install sigrok</pre>
Al instalar '''Sigrok''' instalamos también '''Pulseview'''.

Si al conectar el analizador, echamos un ojo al fichero ''syslog'' vemos que al conectarlo se mapea en un puerto tty.

Si arrancamos '''Pulseview''' (nuestro usuario tiene que estar incluido en el grupo ''dialout''), en la opción ''File::Connect to device'', escogemos la opción ''Openbench'' y le pasamos el puerto. Al pulsar la opción ''Scan for devices'' reconoce el analizador correctamente como un ''Sump Logic Analyzer''.

=== Sump logic analyzer ===

Este es el software recomendado para usar con el analizador.

Descargamos el paquete de la [https://www.sump.org página del proyecto], o más concretamente de [https://www.sump.org/projects/analyzer/ esta página] y descomprimimos en ''~/apps''.

Instalamos las dependencias:

<pre class="{bash}">sudo apt install librxtx-java</pre>
Editamos el fichero ''~/apps/Logic Analyzer/client/run.sh'' y lo dejamos así:

<pre>#!/bin/bash

# java -jar analyzer.jar $*
java -cp /usr/share/java/RXTXcomm.jar:analyzer.jar org.sump.analyzer.Loader</pre>
Y ya funciona.

=== OLS ===


-----

'''Nota''': Pendiente de instalar


-----

[https://www.lxtreme.nl/ols/ Página oficial]

== IceStudio ==

Instalamos dependencias con <code>sudo apt install xclip</code>

Bajamos el ''AppImage'' desde el [https://github.com/FPGAwars/icestudio github de IceStudio] y lo dejamos en <code>~/apps/icestudio</code>

== PlatformIO ==

=== VS Code ===

Añadimos el origen de software:

<pre>curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor &gt; packages.microsoft.gpg
sudo install -o root -g root -m 644 packages.microsoft.gpg /usr/share/keyrings/
sudo sh -c 'echo &quot;deb [arch=amd64 signed-by=/usr/share/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/vscode stable main&quot; &gt; /etc/apt/sources.list.d/vscode.list'</pre>
E instalamos

<pre>sudo apt update
sudo apt install code   # alternativamente code-insiders (es como la versión beta, se pueden instalar los dos)</pre>
Ahora

# lanzamos el editor
# abrimos el gestor de extensiones
# buscamos el platformio ide
# instalamos

Seguimos las instrucciones de [https://docs.platformio.org/en/latest/ide/vscode.html#quick-start aqui]

=== Incluir platform.io CLI en el PATH ===

Esto es una malísima idea, '''NO LO HAGAS'''

Las instrucciones indican que hagamos lo siguiente para usar Platformio desde linea de comandos pero no es conveniente hacerlo.

Modificamos el fichero <code>~/.profile</code> añadiendo las siguientes lineas:

<pre>if [ -d &quot;$HOME/.platformio/penv/bin&quot;] ; then
    PATH=&quot;$PATH:$HOME/.platformio/penv/bin&quot;
fi</pre>
Si quieres usar Platformio desde linea de comandos, es mejor activar manualmente el entorno virtual con <code>source ~/.platformio/penv/bin/activate</code>

=== vscodium ===

<pre class="{bash}">wget -qO - https://gitlab.com/paulcarroty/vscodium-deb-rpm-repo/raw/master/pub.gpg | sudo apt-key add -
echo 'deb https://gitlab.com/paulcarroty/vscodium-deb-rpm-repo/raw/repos/debs/ vscodium main' | sudo tee --append /etc/apt/sources.list.d/vscodium.list
sudo apt update &amp;&amp; sudo apt install codium</pre>
=== Editor Atom ===


-----

''NOTA'': Parece que antes recomendaban instalar Atom para disponer del Platformio CLI, ahora en cambio recomiendan VS Code.


-----

<pre>wget -qO - https://packagecloud.io/AtomEditor/atom/gpgkey | sudo apt-key add -
sudo sh -c 'echo &quot;deb [arch=amd64] https://packagecloud.io/AtomEditor/atom/any/ any main&quot; &gt; /etc/apt/sources.list.d/atom.list'
sudo apt update
sudo apt install atom</pre>
== RepRap ==

=== OpenScad ===

El OpenSCAD está disponible en los orígenes de software, así que <code>sudo apt install openscad</code>.

=== Slic3r ===

Descargamos la estable desde la [https://dl.slic3r.org página web] y como de costumbre descomprimimos en <code>~/apps</code> y creamos un lanzador con ''MenuLibre''

=== Slic3r Prusa Edition ===

Una nueva versión del clásico ''Slic3r'' con muchas mejoras. Descargamos la ''appimage'' desde la [https://www.prusa3d.com/slic3r-prusa-edition/ página web] y ya sabeis, descomprimir en <code>~/apps</code> y dar permisos de ejecución.

=== ideaMaker ===

Una aplicación más para generar gcode con muy buena pinta, tenemos el paquete ''deb'' disponible en su [https://www.raise3d.com/pages/ideamaker página web]. Instalamos con el gestor de software.

=== Ultimaker Cura ===

Descargamos el ''AppImage'' desde la [https://github.com/Ultimaker/Cura/releases página web]

=== Pronterface ===

Seguimos las instrucciones para Ubuntu Bionic:

Instalamos las dependencias:

Clonamos el repo:

<pre>cd ~/apps
git clone https://github.com/kliment/Printrun.git
cd Printrun
mkvirtualenv -p /usr/bin/python3 printrun
python -m pip install https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ubuntu-20.04/wxPython-4.1.0-cp38-cp38-linux_x86_64.whl
pip install -r requirements.txt
# sudo apt-get install libdbus-glib-1-dev libdbus-1-dev</pre>
Y ya lo tenemos todo listo para ejecutar.

== Cortadora de vinilos ==

=== Inkcut ===

Instalado en un entorno virtual:

<pre class="{bash}">mkvirtualenv -p `which python3` inkcut

sudo apt install libxml2-dev libxslt-dev libcups2-dev

pip install PyQt5

pip install inkcut</pre>
=== Plugin para inkscape ===

Instalamos dependencias:

<pre class="{bash}">pip install python-usb</pre>
Instalamos el fichero <code>.deb</code> desde la web https://github.com/fablabnbg/inkscape-silhouette/releases

= Aplicaciones de gráficos =

== LibreCAD ==

Diseño en 2D

<pre>sudo apt install librecad</pre>
== FreeCAD ==

No hay ppa disponible para Ubuntu 20.

Instalamos ''AppImage'' desde [https://wiki.freecadweb.org/AppImage#FreeCAD_AppImages aquí]

Dejo la instalación desde ppa como recordatorio.

<pre>sudo add-apt-repository ppa:freecad-maintainers/freecad-stable
sudo apt update
sudo install freecad</pre>

-----

'''NOTA:''' the ccx package brings CalculiX support to the FEM workbench, and needs to be installed separately.


-----

== Inkscape ==

El programa libre para creación y edición de gráficos vectoriales.

<pre>sudo add-apt-repository ppa:inkscape.dev/stable
sudo apt update
sudo apt install inkscape</pre>
== Gimp ==

El programa para edición y retocado de imágenes.

Parece que ahora mismo los repos están más actualizados que el ppa. Así que bastaría con:

<pre class="{bash}">sudo apt install gimp gimp-data gimp-texturize \
gimp-data-extras gimp-gap gmic gimp-gmic</pre>
De todas formas dejo aquí las instrucciones para instalar desde el ppa por si hacen falta algún dia:

<pre>sudo apt remove gimp gimp-data
sudo add-apt-repository ppa:otto-kesselgulasch/gimp
sudo apt update
sudo apt upgrade
sudo apt install gimp gimp-data gimp-texturize \
gimp-data-extras gimp-gap gmic gimp-gmic gimp-python</pre>
=== Plugins de Gimp ===

Para instalar los principales plugins basta con:

<pre>sudo apt install gimp-plugin-registry</pre>
{|
|width="98%"| Esta sección ya no está vigente
|-
| #### resynthesizer
|-
| Descargamos el plugin desde [https://github.com/bootchk/resynthesizer aquí] y descomprimimos el fichero en <code>~/.config/GIMP/2.10/plug-ins</code>
|-
| Tenemos que asegurarnos que los fichero ''python'' son ejecutables:
|-
| ~~~~ chmod 755 ~/.config/GIMP/2.10/plug-ins/*.py ~~~~
|}

== Krita ==

La versión disponible en orígenes de software está bastante por detrás de la disponible en la web. Basta con descargar el ''Appimage'' desde la [https://krita.org página web]

Lo copiamos a <code>~/apps/krita</code> y creamos un lanzador con el editor de menús.

Alternativamente también lo tenemos disponible por ppa en https://launchpad.net/~kritalime/+archive/ubuntu/ppa

== MyPaint ==

Desde el [https://github.com/mypaint/ github] tenemos disponible la última versión en formato ''appimage''. La descargamos la dejamos en <code>~/apps</code> y creamos un acceso con ''Menulibre'', como siempre.

== Alchemy ==

Igual que el ''MyPaint'' descargamos desde [http://al.chemy.org la página web], descomprimimos en <code>~/apps</code> y creamos un accso con ''Menulibre''.

== Capturas de pantalla ==

El [https://flameshot.js.org/#/ ''flameshot''] cubre el 99% de mis necesidades: <code>sudo apt install flameshot</code>

El [https://github.com/DamirPorobic/ksnip ''ksnip''] por si tenemos que hacer una captura con retardo lo instalé con un ''appimage''.

Shutter vuelve a estar disponible, al instalar desde este ppa ya queda con las opciones de edición habilitadas:

<pre class="{bash}">sudo add-apt-repository ppa:linuxuprising/shutter
sudo apt update
sudo apt install shutter</pre>
== Reoptimizar imágenes ==

=== ImageMagick ===

Instalamos desde los repos, simplemente:

<pre>sudo apt install imagemagick</pre>
=== Imagine ===

Nos bajamos un ''AppImage'' desde el [https://github.com/meowtec/Imagine/releases github] de la aplicación

== dia ==

Un programa para crear diagramas

<pre>sudo apt install dia dia-shapes gsfonts-x11</pre>
== Blender ==

Bajamos el Blender linkado estáticamente de [https://www.blender.org la página web] y lo descomprimimos en <code>~/apps/blender</code>.

== Structure Synth ==

Instalado desde repos, junto con sunflow para explorar un poco.

<pre>sudo apt install structure-synth sunflow</pre>
== Heron animation ==

Descargamos el programa desde [https://heronanimation.brunolefevre.net/ su página web] y como siempre descomprimimos en <code>~/apps/heron</code>

== Stopmotion ==

Primero probamos el del repo: <code>sudo apt install stopmotion</code>

== Instalación del driver digiment para tabletas gráficas Huion ==

He intentado un par de veces instalar con el fichero <code>deb</code> pero parece que no funciona.

Para hacer la instalación via DKMS el truco está en:

* Dejar el código fuente en un directorio de la forma <code>/usr/src/&lt;PROJECTNAME&gt;-&lt;VERSION&gt;</code>
* Lanzar el <code>build</code> pero usando esta vez <code>&lt;PROJECTNAME&gt;/&lt;VERSION&gt;</code>

Descargamos los últimos drivers desde [https://github.com/DIGImend/digimend-kernel-drivers/releases la página oficial de releases], en el momento de escribir esto descargamos la versión V9.

Descomprimimos en <code>/usr/src/digimend-9</code>

<pre class="{bash}">cd /usr/src
sudo xvzf &lt;path-to-digimend-kernel-drivers-9&gt; .
sudo dkms build digimend-kernel-drivers/9
sudo dkms install digimend/9</pre>
Para comprobar:

<pre>xinput --list
dkms status</pre>
Referencia:

* [https://davidrevoy.com/article331/setup-huion-giano-wh1409-tablet-on-linux-mint-18-1-ubuntu-16-04 Aquí]

= Sonido =

== Spotify ==

Spotify instalado desde las opciones de Linux Mint

== Audacity ==

Añadimos ppa:

<pre>sudo add-apt-repository ppa:ubuntuhandbook1/audacity
sudo apt-get update
sudo apt install audacity</pre>
Instalamos también el plugin [https://theaudacitytopodcast.com/chriss-dynamic-compressor-plugin-for-audacity/ Chris’s Dynamic Compressor plugin]

== Clementine ==

La version disponible en los orígenes de software parece al dia:

<pre>sudo apt install clementine</pre>
= Video =

== Shotcut ==

Nos bajamos la ''AppImage'' para Linux desde la [https://www.shotcut.org/ página web].

La dejamos en <code>~/apps/shotcut</code> y:

<pre>cd
chmod 744 Shotcutxxxxxx.AppImage
./Shotcutxxxxxx.AppImage</pre>
== kdenlive ==

Está disponible como ppa o como ''appimage''. Lo he bajado como ''appimage'' para probarlo.

== Openshot ==

También descargado desde su web como ''appimage''.

== Grabación de screencast ==

=== Vokoscreen y Kazam ===

Instalados desde los repos oficiales:

<pre>sudo apt update
sudo apt install vokoscreen kazam</pre>
== Grabación de podcast ==

=== Mumble ===

Instalamos desde PPA

<pre>sudo add-apt-repository ppa:mumble/release
sudo apt update
    sudo apt install mumble</pre>
= Fotografía =

== Rawtherapee ==

Bajamos el AppImage desde la [http://rawtherapee.com/ página web] al directorio <code>~/apps/rawtherapee</code>.

<pre>cd
chmod 744 RawTherapeexxxxxx.AppImage
./RawTherapeexxxxxx.AppImage</pre>
Al ejecutarla la primera vez ya se encarga la propia aplicación de integrarse en nuestro sistema.

== Darktable ==

Instalamos ppa:

<pre>echo 'deb http://download.opensuse.org/repositories/graphics:/darktable/xUbuntu_20.04/ /' | sudo tee /etc/apt/sources.list.d/graphics:darktable.list
curl -fsSL https://download.opensuse.org/repositories/graphics:darktable/xUbuntu_20.04/Release.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/graphics:darktable.gpg &gt; /dev/null
sudo apt update
sudo apt install darktable</pre>
Se instala la última versión de Darktable (3.0.2)

= Seguridad =

== Autenticación en servidores por clave pública ==

Generar contraseñas para conexión servidores remotos:

<pre>cd ~
ssh-keygen -b 4096 [-t dsa | ecdsa | ed25519 | rsa | rsa1]
cat .ssh/</pre>
Solo resta añadir nuestra clave pública en el fichero <code>authorized_keys</code> del servidor remoto.

<pre>cat ~/.ssh/id_xxx.pub | ssh user@hostname 'cat &gt;&gt; .ssh/authorized_keys'</pre>
[https://www.digitalocean.com/community/tutorials/understanding-the-ssh-encryption-and-connection-process ¿Cómo funciona esto?]

== Claves gpg ==

<code>gpg --gen-key</code> Para generar nuestra clave.

* '''Siempre''' hay que ponerle una fecha de expiración, la puedes cambiar más tarde.
* '''Siempre''' hay que escoger la máxima longitud posible

== Seahorse ==

Para manejar todas nuestras claves con comodidad:

<code>sudo apt install seahorse</code>

== Conexión a github con claves ssh ==

Usando este método podemos conectarnos a github sin tener que teclear la contraseña en cada conexión.

=== Claves ssh ===

Podemos echar un ojo a nuestras claves desde <code>seahorse</code> la aplicación de gestión de claves que hemos instalado. También podemos ver las claves que tenemos generadas:

<pre>ls -al ~/.ssh</pre>
En las claves listadas nuestras claves públicas aparecerán con extensión <code>.pub</code>

También podemos comprobar que claves hemos añadido ya a nuestro agente ssh con:

<pre>ssh-add -l</pre>
Para generar una nueva pareja de claves ssh:

<pre>ssh-keygen -t rsa -b 4096 -C &quot;your_email@example.com&quot;</pre>
Podremos dar un nombre distintivo a los ficheros de claves generados y poner una contraseña adecuada a la clave. Si algún dia queremos cambiar la contraseña:

<pre>ssh-keygen -p</pre>
Ahora tenemos que añadir nuestra clave ssh en nuestra cuenta de github, para ello editamos con nuestro editor de texto favorito el fichero <code>~/.ssh/id_rsa.pub</code> y copiamos el contenido integro. Después pegamos ese contenido en el cuadro de texto de la web de github.

Para comprobar que las claves instaladas en github funcionan correctamente:

<pre>ssh -T git@github.com
Hi salvari! You've successfully authenticated, but GitHub does not provide shell access.</pre>
Este mensaje indica que todo ha ido bien.

Ahora en los repos donde queramos usar ssh debemos cambiar el remote:

<pre>git remote set-url origin git@github.com:$USER/$REPONAME.git</pre>
== Signal ==

El procedimiento recomendado en la página oficial:

<pre>curl -s https://updates.signal.org/desktop/apt/keys.asc | sudo apt-key add -
echo &quot;deb [arch=amd64] https://updates.signal.org/desktop/apt xenial main&quot; | sudo tee -a /etc/apt/sources.list.d/signal-xenial.list
sudo apt update &amp;&amp; sudo apt install signal-desktop</pre>

-----

'''NOTA''': Parece que no funciona. Lo he instalado via ''flatpack''


-----

== Lector DNI electrónico ==

Instalamos:

<pre>sudo apt-get install pcscd pcsc-tools libccid</pre>
Como root ejecutamos pcsc_scan:

<pre>root@rasalhague:~# pcsc_scan 
PC/SC device scanner
V 1.4.23 (c) 2001-2011, Ludovic Rousseau &lt;ludovic.rousseau@free.fr&gt;
Compiled with PC/SC lite version: 1.8.11
Using reader plug'n play mechanism
Scanning present readers...
Waiting for the first reader...</pre>
Si insertamos el lector veremos algo como esto:

<pre>root@rasalhague:~# pcsc_scan 
PC/SC device scanner
V 1.4.23 (c) 2001-2011, Ludovic Rousseau &lt;ludovic.rousseau@free.fr&gt;
Compiled with PC/SC lite version: 1.8.11
Using reader plug'n play mechanism
Scanning present readers...
Waiting for the first reader...found one
Scanning present readers...
0: C3PO LTC31 v2 (11061005) 00 00

Wed Jan 25 01:17:20 2017
Reader 0: C3PO LTC31 v2 (11061005) 00 00
  Card state: Card removed,</pre>
Si insertamos un DNI veremos que se lee la información de la tarjeta insertada:

<pre>Reader 0: C3PO LTC31 v2 (11061005) 00 00
  Card state: Card inserted, </pre>
y mas rollo

Instalamos ahora el modulo criptográfico desde [https://www.dnielectronico.es/PortalDNIe/PRF1_Cons02.action?pag=REF_1112 este enlace]

Y además:

<pre>aptitude install pinentry-gtk2 opensc</pre>
= Virtualizaciones y contenedores =

== Instalación de ''virtualBox'' ==

Lo hacemos con los origenes de software oficiales (alternativamente, podríamos hacerlo manualmente):

<pre># Importamos la clave gpg
wget -q https://www.virtualbox.org/download/oracle_vbox_2016.asc -O- | sudo apt-key add -

# Añadimos el nuevo origen de software
sudo add-apt-repository &quot;deb [arch=amd64] https://download.virtualbox.org/virtualbox/debian $(. /etc/os-release; echo &quot;$UBUNTU_CODENAME&quot;) contrib&quot;

# Actualizamos la base de datos de paquetes
sudo apt update</pre>
Ahora podemos comprobar que además del paquete ''virtualbox'' tenemos varios paquetes con número de versión (p.ej. _virtualbox.6.1), estos últimos son los que hemos añadido (compruebalo con <code>apt-cache policy [nombrepaquete]</code>)

Instalamos el que nos interesa:

<pre class="{bash}">sudo apt install virtualbox-6.1</pre>
Descargamos también el [https://www.virtualbox.org/wiki/Downloads VirtualBox Extension Pack], este paquete lo instalaremos desde el propio interfaz de usuario del ''VirtualBox''. Y lo instalamos con el comando:

<pre>sudo VBoxManage extpack install ./Oracle_VM_VirtualBox_Extension_Pack-6.1.2.vbox-extpack </pre>
Sólo nos queda añadir nuestro usuario al grupo <code>vboxusers</code>, con el comando <code>sudo gpasswd -a username vboxusers</code>, y tendremos que cerrar la sesión para refrescar nuestros grupos.

== qemu ==

Instalamos desde el repo oficial:

<pre>sudo apt install qemu-kvm qemu virt-manager virt-viewer libvirt-bin</pre>
== Docker ==

Tenemos que añadir el repositorio correspondiente a nuestra distribución:

<pre># Be safe
sudo apt remove docker docker-engine docker.io
sudo apt autoremove
sudo apt update

# Install pre-requisites
sudo apt install ca-certificates curl

# Import the GPG key

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

# Next, point the package manager to the official Docker repository

sudo add-apt-repository &quot;deb [arch=amd64] https://download.docker.com/linux/ubuntu $(. /etc/os-release; echo &quot;$UBUNTU_CODENAME&quot;) stable&quot;

# Update the package database

sudo apt update
#

apt-cache policy docker-ce

sudo apt install docker-ce

sudo gpasswd -a salvari docker</pre>
Esto dejará el servicio ''docker'' funcionando y habilitado (arrancará en cada reinicio del ordenador)

La forma de pararlo es:

<pre class="{bash}">sudo systemctl stop docker
sudo systemctl disable docker
systemctl status docker</pre>
Añadimos el ''bundle'' '''docker''' en nuestro fichero <code>~/.zshrc</code> para tener autocompletado en comandos de docker.

Para usar ''docker'' tendremos que arrancarlo, con los alias de nuestro sistema para ''systemd'' ejecutamos:

<pre class="{bash}">scst docker  # para arrancar el servicio

scsp docker  # para parar el servicio</pre>
=== docker-compose ===

* Nos bajamos la última versión disponible de [https://github.com/docker/compose/releases las releases de github]
* Movemos el fichero que hemos descargado a <code>/usr/local/bin/docker-compose</code>
* Y le damos permisos de ejecución <code>sudo chmod +x /usr/local/bin/docker-compose</code>

= Utilidades para mapas y cartografía =

== josm ==

Descargamos y añadimos la clave gpg:

<pre>wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo apt-key add -</pre>
Añadimos el origen de software:

<pre>sudo add-apt-repository &quot;deb [arch=amd64] https://josm.openstreetmap.de/apt $(. /etc/os-release; echo &quot;$UBUNTU_CODENAME&quot;) universe&quot;</pre>
Y ahora procedemos a la instalación:

<pre>sudo apt update
sudo apt install openjfx josm </pre>
Alternativamente también podemos instalar la versión “nightly” con el siguienete comando, pero tendréis actualizaciones diarias:

<pre>sudo apt josm-latest</pre>
Ya estamos listos para editar Open Street Map offline.

== MOBAC ==

Bajamos el paquete desde [http://mobac.sourceforge.net/ la página web] y descomprimimos en <code>~/apps/mobac</code> como de costumbre nos creamos una entrada de menú con ''MenuLibre''.

Conviene bajarse wms adicionales para MOBAC y leerse [http://mobac.sourceforge.net/wiki/index.php/Custom_XML_Map_Sources la wiki]

=== Referencias ===

*[Cartografía digital] (https://digimapas.blogspot.com.es/2015/01/oruxmaps-vii-mapas-de-mobac.html)

== QGIS ==

Añadimos la clave gpg:

<pre>wget -q  https://qgis.org/downloads/qgis-2017.gpg.key -O- | sudo apt-key add -</pre>
Ejecutamos:

<pre>sudo add-apt-repository &quot;deb [arch=amd64] https://qgis.org/debian $(. /etc/os-release; echo &quot;$UBUNTU_CODENAME&quot;) main&quot;</pre>
E instalamos como siempre

<pre>sudo apt update
sudo apt install qgis</pre>
=== Referencias ===

* [https://mappinggis.com/2015/09/como-conectar-con-servicios-wms-y-wfs-con-arcgis-qgis-y-gvsig/ Conectar WMS con QGIS]
* [https://www.altergeosistemas.com/blog/2014/03/28/importando-datos-de-osm-en-qgis-2/ Importar OSM en QGIS]
* [http://learnosm.org/es/osm-data/osm-in-qgis/ Learn OSM]
* [http://www.qgistutorials.com/es/docs/downloading_osm_data.html QGIS Tutorials]

= Recetas variadas =

== Solucionar problemas de menús duplicados usando menulibre ==

{|
| '''Nota''': Ya no uso ''MenuLibre''
|}

En el directorio <code>~/.config/menus/applications-merged</code> borramos todos los ficheros que haya.

== Formatear memoria usb ==

“The driver descriptor says the physical block size is 2048 bytes, but Linux says it is 512 bytes.”

Este comando borró todas las particiones de la memoria:

<code>sudo dd if=/dev/zero of=/dev/sdd bs=2048 count=32 &amp;&amp; sync</code>

I’m assuming your using gparted.

First delete whatever partitions you can…just keep pressing ignore.

There will be one with a black outline…you will have to unmount it…just right click on it and unmount.

Again you will have to click your way through ignore..if fix is an option choose it also.

Once all this is done… you can select the device menu and choose new partition table.

Select MSdos

Apply and choose ignore again.

Once it’s done it show it’s real size.

Next you can format the drive to whichever file system you like.

It’s a pain in the behind this way, but it’s the only way I get it done..I put live iso’s on sticks all the time and have to remove them. I get stuck going through this process every time.

== Copiar la clave pública ssh en un servidor remoto ==

<code>cat /home/tim/.ssh/id_rsa.pub | ssh tim@just.some.other.server 'cat &gt;&gt; .ssh/authorized_keys'</code>

O también:

<code>ssh-copy-id -i ~/.ssh/id_rsa.pub username@remote.server</code>

== ssh access from termux ==

https://linuxconfig.org/ssh-into-linux-your-computer-from-android-with-termux

== SDR instalaciones varias ==

Vamos a trastear con un dispositivo [https://www.rtl-sdr.com/ RTL-SDR.com].

Tenemos un montón de información en el blog de [https://sdrgal.wordpress.com/ SDR Galicia] y tienen incluso una guia de instalación muy completa, pero yo voy a seguir una guía un poco menos ambiciosa, por lo menos hasta que pueda hacer el curso que imparten ellos mismos (SDR Galicia)

La guía en cuestión la podemos encontrar [https://ranous.wordpress.com/rtl-sdr4linux/ aquí]

Seguimos los pasos de instalación:

* La instalación de <code>git</code>, <code>cmake</code> y <code>build-essential</code> ya la tengo hecha.

<pre>sudo apt-get install libusb-1.0-0-dev</pre>
== Posible problema con modemmanager y micros programables ==

Programando el ''Circuit Playground Express'' con el ''Arduino IDE'' tenía problemas continuos para hacer los ''uploads'', al parecer el servicio ''ModemManager'' es el culpable, se pasa todo el tiempo capturando los nuevos puertos serie por que considera que todo es un modem.

Una prueba rápida para comprobarlo: <code>sudo systemctl stop ModemManager</code>

Con esto funciona todo bien, pero en el siguiente arranque volvera a cargarse.

Para dar una solución definitiva se puede programar una regla para impedir que el ''ModemManager'' capture el puerto con un dispositivo

Creamos un fichero con permisos de <code>root</code> en el directorio <code>/etc/udev/rules.d</code> que llamaremos: <code>99-arduino.rules</code>

Dentro de ese fichero especificamos los codigos VID/PID que se deben ignorar:

<pre># for arduino brand, stop ModemManager grabbing port
ATTRS{idVendor}==&quot;2a03&quot;, ENV{ID_MM_DEVICE_IGNORE}=&quot;1&quot;
# for sparkfun brand, stop ModemManager grabbing port
ATTRS{idVendor}==&quot;1b4f&quot;, ENV{ID_MM_DEVICE_IGNORE}=&quot;1&quot;</pre>
Ojo que si tienes SystemV no va a funcionar.

https://starter-kit.nettigo.eu/2015/serial-port-busy-for-avrdude-on-ubuntu-with-arduino-leonardo-eth/

https://www.codeproject.com/Tips/349002/Select-a-USB-Serial-Device-via-its-VID-PID

== Programar los nanos con chip ch340 o ch341 ==

Linux mapea el chip correctamente en un puerto <code>/dev/ttyUSB0</code> y con eso basta, que no te lien con el cuento de “drivers para linux”

Todo lo que hace falta es configurar correctamente el ''Arduino IDE'', hay que escoger:

<pre>Board: &quot;Arduino Nano&quot;
Processor: &quot;ATmega168&quot;
Port: &quot;/dev/ttyUSB0&quot;</pre>
Y ya funciona todo.

<references />