https://github.com/swomf/netmask-zsh-theme

A utilitarian, horizontal-space-saving oh-my-zsh theme that shows your IP, even on Termux
https://github.com/swomf/netmask-zsh-theme

oh-my-zsh-theme zsh-theme zsh-theme-termux

Last synced: 8 months ago
JSON representation

A utilitarian, horizontal-space-saving oh-my-zsh theme that shows your IP, even on Termux

• Host: GitHub
• URL: https://github.com/swomf/netmask-zsh-theme
• Owner: swomf
• License: gpl-3.0
• Created: 2024-05-11T22:05:21.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-03-29T22:30:00.000Z (8 months ago)
• Last Synced: 2025-03-29T23:23:56.797Z (8 months ago)
• Topics: oh-my-zsh-theme, zsh-theme, zsh-theme-termux
• Language: C
• Homepage:
• Size: 189 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-zsh-plugins - netmask - Termux-first theme. Includes decorators for ip address, full path to current directory, `git` status and python virtual environment. (Themes / ZSH on Windows)
• fucking-awesome-zsh-plugins - netmask - Termux-first theme. Includes decorators for ip address, full path to current directory, `git` status and python virtual environment. (Themes / ZSH on Windows)

README

          
# Netmask theme

A non-intrusive, Termux-first utilitarian theme for [oh-my-zsh](https://github.com/ohmyzsh/ohmyzsh).

* IPv4 address

  * Cross-platform: uses own implementation via C stdlib

  to avoid `ifconfig`/`ip addr`/Termux permission inconsistencies

* Full directory structure

* Git branch and status

* Virtual environment

* Support for the new high-speed [async prompt](https://github.com/ohmyzsh/ohmyzsh/issues/12328#issuecomment-2043492331)

![Netmask theme preview](preview.png)

Tested on rootless Android 13+ Termux and various

desktop glibc Linux distributions.

## Installation

```bash

git clone https://github.com/swomf/netmask-zsh-theme

cd netmask-zsh-theme

make config # Recommended. May not be necessary.

make && make install

# if necessary, use `sudo -E make install` instead.

```

### Why `make config?`

By default, the theme will print the first network interface that

starts with `wl` (e.g. `wlan0`, `wlp3s0`). However, some may prefer

to explicitly define their wanted interface, or change it to `tun0`

or something else.

Run `make help` for more information.

## Roadmap

* [ ] Improve installation process when using `sudo`

  * `sudo -E` is sometimes needed because the presence of

  ohmyzsh is detected in the project Makefile via the `$ZSH` env var;

  this may not be defined in `/root/.zshrc` for system-wide ohmyzsh

  installations.

* [ ] Test on non-glibc systems

  * [ ] macOS (Apple C Library)

  * [ ] \*BSD (libc)

  * [ ] Alpine Linux/Void Linux (musl)

  * [ ] MinGW-w64 (msvcrt)

## Inspiration

* [rkj-repos zsh theme](https://github.com/ohmyzsh/ohmyzsh/blob/master/themes/rkj-repos.zsh-theme) (MIT): some icon choices

* [heapbytes zsh theme](https://github.com/heapbytes/heapbytes-zsh) (MIT): main inspiration

No code was reused.