# Tips rápidos

Trucos puntuales de macOS y sus apps: una página por tip, con título descriptivo (app + qué quieres hacer + cómo) para que la búsqueda de BookStack encuentre el problema exacto directamente.

# iTerm2 — mostrar u ocultar la franja de timestamps (hora) de la sesión con Shift+Cmd+E

## iTerm2: franja de horas junto a la salida (timestamps)

Si en algún momento aparece una columna a la derecha de la ventana con la hora de cada línea, es la función **Show Timestamps** de iTerm2. Es fácil activarla sin querer con el atajo de teclado, y si no sabes qué la encendió, desconcierta.

### Atajo

`Shift + Cmd + E` (⇧⌘E) alterna el timestamp on/off en la sesión activa, al vuelo, sin tocar ninguna configuración persistente del perfil.

### Menu

`View → Show Timestamps` hace lo mismo desde el menú, por si se te olvida el atajo.

### Notas

- El toggle es por sesión: no afecta a otras pestañas ni paneles abiertos en ese momento.
- No cambia el comportamiento por defecto de sesiones nuevas. Para eso hay una opción persistente en `Settings (⌘,) → Profiles → Session`, un desplegable de timestamps con tres modos: siempre, nunca, o solo al pasar el ratón por encima.

##### Aviso
Esta documentación y su contenido, no implica que funcione en tu caso o determinados casos. 
También implica que tienes conocimientos sobre lo que trata, y que en cualquier caso tienes copias de seguridad.
El contenido el contenido se entrega, tal y como está, sin que ello implique ningún obligación ni responsabilidad por parte de [Castris](https://castris.com)

Si necesitas soporte profesional puedes contratar con Castris [soporte profesional](https://intranet.castris.com/store/soporte-profesional).

# pip3 en macOS (Homebrew): evitar el error externally-managed-environment instalando con pipx

## Instalar programas/script pyhton con pip3 en entorno Mac con Homebrew

Muchas veces en mac quieres instalar algo con `pip` pero tu instalación de `pip3` ewsta mantenida por [Homebrew](https://brew.sh/) y obtines el error de abajo

```
pip3 install "headroom-ai[all]"
error: externally-managed-environment

× This environment is externally managed
╰─> To install Python packages system-wide, try brew install
    xyz, where xyz is the package you are trying to
    install.

    If you wish to install a Python library that isn't in Homebrew,
    use a virtual environment:

    python3 -m venv path/to/venv
    source path/to/venv/bin/activate
    python3 -m pip install xyz

    If you wish to install a Python application that isn't in Homebrew,
    it may be easiest to use 'pipx install xyz', which will manage a
    virtual environment for you. You can install pipx with

    brew install pipx

    You may restore the old behavior of pip by passing
    the '--break-system-packages' flag to pip, or by adding
    'break-system-packages = true' to your pip.conf file. The latter
    will permanently disable this error.

    If you disable this error, we STRONGLY recommend that you additionally
    pass the '--user' flag to pip, or set 'user = true' in your pip.conf
    file. Failure to do this can result in a broken Homebrew installation.

    Read more about this behavior here: <https://peps.python.org/pep-0668/>

note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages.
hint: See PEP 668 for the detailed specification.
```

### Resumen

```
This environment is externally managed
╰─> To install Python packages system-wide, try brew install
    xyz, where xyz is the package you are trying to
    install.
```
    
### Solución

Usar `pipx`

```
brew install pipx
pipx install "headroom-ai[all]"
  installed package headroom-ai 0.26.0, installed using Python 3.14.6
  These apps are now available
    - headroom
done! ✨ 🌟 ✨
```



##### Aviso
Esta documentación y su contenido, no implica que funcione en tu caso o determinados casos. 
También implica que tienes conocimientos sobre lo que trata, y que en cualquier caso tienes copias de seguridad.
El contenido el contenido se entrega, tal y como está, sin que ello implique ningún obligación ni responsabilidad por parte de [Castris](https://castris.com)

Si necesitas soporte profesional puedes contratar con Castris [soporte profesional](https://intranet.castris.com/store/soporte-profesional).