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: 3 months 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 (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-02-21T17:12:57.000Z (4 months ago)
• Last Synced: 2024-02-21T18:31:25.866Z (4 months ago)
• Topics: cli, functional, go, golang, groups, linux, tui, unix, users
• Language: Go
• Homepage:
• Size: 53.7 KB
• Stars: 99
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-stars - ariasmn/ugm - A terminal based UNIX user and group browser (Go)
• cli-apps - ugm - A terminal based UNIX user and group browser. (<a name="system"></a>System tools)
• awesome-cli-apps - ugm - A terminal based UNIX user and group browser. (<a name="system"></a>System tools)

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)