https://github.com/ariasmn/ugm

A terminal based UNIX user and group browser
https://github.com/ariasmn/ugm

cli functional go golang groups linux tui unix users

Last synced: about 1 month ago
JSON representation

A terminal based UNIX user and group browser

• Host: GitHub
• URL: https://github.com/ariasmn/ugm
• Owner: ariasmn
• License: mit
• Created: 2022-05-26T19:11:48.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-02-21T17:12:57.000Z (10 months ago)
• Last Synced: 2024-08-01T13:29:23.082Z (4 months ago)
• Topics: cli, functional, go, golang, groups, linux, tui, unix, users
• Language: Go
• Homepage:
• Size: 53.7 KB
• Stars: 115
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• charm-in-the-wild - ugm - A unix user and group browser. (_built with Bubble Tea_) (Applications / System Management)

README

        
ugm

======



    

    



A TUI to view information about UNIX users and groups.

![How it works](https://user-images.githubusercontent.com/33121576/180660203-9c9f3801-5298-4ebc-b23a-e25e35582974.gif)

## Installation

Install directly using Go: 

```

go install github.com/ariasmn/ugm@latest

```

or download from [releases](https://github.com/ariasmn/ugm/releases).

## Usage

To launch the tool, run the `ugm` command.

| KeyBoard              | Description                           |

| :------:              | :------------------------------------:|

|  Ctrl+c / q / Esc     | Exit                                  |

|  Tab                  | Switch between user and group view    |

|    ↑ / k              | Previous item                         |

|    ↓ / j              | Next item                             |

|    ← / h              | Previous page                         |

|    → / l              | Next page                             |

|    /                  | Enter search keywords                 |

|  Enter                | Apply search                          |

## Notes

`ugm` only works on UNIX based OS.

On OSX, the information reported will not be accurate. The tool relies on the `/etc/passwd` and `/etc/group` files, which are only consulted in OSX in single-user mode, and the system uses [DirectoryService](https://developer.apple.com/documentation/devicemanagement/directoryservice) to manage user and groups.

## Built with

 - [bubbletea](https://github.com/charmbracelet/bubbletea) and its ecosystem

 - [bubble-table](https://github.com/Evertras/bubble-table)