{"id":46500643,"url":"https://github.com/wattox00/usys","last_synced_at":"2026-04-08T08:01:52.026Z","repository":{"id":338265519,"uuid":"1156338819","full_name":"WattoX00/usys","owner":"WattoX00","description":"Linux user manager","archived":false,"fork":false,"pushed_at":"2026-03-24T07:05:45.000Z","size":133,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-25T08:52:35.952Z","etag":null,"topics":["group-manager","linux","linux-server-management","linux-user-management","linux-user-manager","permission-manager","sysadmin-tool","user-manager"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/WattoX00.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-12T14:38:25.000Z","updated_at":"2026-03-24T07:05:48.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/WattoX00/usys","commit_stats":null,"previous_names":["wattox00/user-manager","wattox00/usys"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/WattoX00/usys","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WattoX00%2Fusys","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WattoX00%2Fusys/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WattoX00%2Fusys/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WattoX00%2Fusys/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WattoX00","download_url":"https://codeload.github.com/WattoX00/usys/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WattoX00%2Fusys/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31545907,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T16:28:08.000Z","status":"online","status_checked_at":"2026-04-08T02:00:06.127Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["group-manager","linux","linux-server-management","linux-user-management","linux-user-manager","permission-manager","sysadmin-tool","user-manager"],"created_at":"2026-03-06T13:09:58.172Z","updated_at":"2026-04-08T08:01:52.020Z","avatar_url":"https://github.com/WattoX00.png","language":"Python","funding_links":["https://www.paypal.com/paypalme/wattox"],"categories":[],"sub_categories":[],"readme":"# USYS – Linux User Manager\r\n\r\n[![Version](https://img.shields.io/badge/version-0.1.3-blue?style=for-the-badge)](https://github.com/WattoX00/usys/releases/tag/v0.1.3)\r\n![Python](https://img.shields.io/badge/python-3.9%2B-blue?style=for-the-badge)\r\n[![PyPI](https://img.shields.io/pypi/v/usys?style=for-the-badge)](https://pypi.org/project/usys/)\r\n![Status](https://img.shields.io/badge/status-active-success?style=for-the-badge)\r\n![Build](https://img.shields.io/github/actions/workflow/status/wattox00/usys/publish.yml?style=for-the-badge)\r\n[![License](https://img.shields.io/github/license/wattox00/usys?style=for-the-badge)](https://github.com/WattoX00/usys/blob/main/LICENSE)\r\n\r\nUSYS is a simple command-line Linux user and group management tool.\r\nIt provides an interactive interface to manage users and groups using\r\nclear commands and short aliases.\r\n\r\n\u003cdetails\u003e\r\n\u003csummary\u003e📚 Contents\u003c/summary\u003e\r\n  \r\n- [Installation](#installation)\r\n- [Features](#features)\r\n- [Disclaimer](#disclaimer)\r\n- [Usage](#usage)\r\n- [Commands](#commands)\r\n- [Support](#support)\r\n- [License](#license)\r\n\r\n\u003c/details\u003e\r\n\r\n## Installation\r\n\r\n```\r\npip install usys\r\n```\r\n\r\n\u003e [!IMPORTANT]\r\n\u003e `usys` is a terminal application. I recommend installing it with `pipx`.\r\n\r\n## Features\r\n\r\n- Create, modify, and delete users\r\n- Create and manage groups\r\n- Add users to groups\r\n- View user and group information\r\n- Simple command aliases for faster usage\r\n\r\n## Disclaimer:\r\nThis program may not always work as intended. Use it at your own risk,\r\nespecially in production environments or large projects.\r\n\r\nThe program was primarily tested on Arch Linux. Other Linux distributions\r\nmay behave differently.\r\n\r\nMost operations require sudo permissions (except for listing functions),\r\nso make sure you understand what the program does before using it.\r\n\r\n## Usage:\r\nNavigate between shells using their commands. For example, type\r\n'user' or 'u' to enter the user shell mode. Inside each shell you can\r\nexecute commands related to that category. Each shell also provides\r\nits own help functions.\r\n\r\n## Commands:\r\n\u003cdetails\u003e\r\n\u003csummary\u003eClick to open\u003c/summary\u003e\r\n\r\n  \r\n### 📦 Root Commands\r\nThese commands switch you into dedicated management shells:\r\n\r\n| Alias | Command      | Description                       |\r\n| ----- | ------------ | --------------------------------- |\r\n| `u`   | `user`       | Enter user management shell       |\r\n| `g`   | `group`      | Enter group management shell      |\r\n| `p`   | `permission` | Enter permission management shell |\r\n| `ss`  | `ssh`        | Enter SSH setup shell             |\r\n| `sa`  | `samba`      | Enter Samba setup shell           |\r\n| `a`   | `apache`     | Enter Apache setup shell          |\r\n| `h`   | `help`       | Show root help menu               |\r\n| `q`   | `exit`       | Exit program                      |\r\n\r\n### 👤 User Commands\r\n\r\n| Alias | Command          | Description             |\r\n| ----- | ---------------- | ----------------------- |\r\n| `au`  | `adduser`        | Create a new user       |\r\n| `du`  | `deluser`        | Delete a user           |\r\n| `pw`  | `passwd`         | Change user password    |\r\n| `ag`  | `appendgroup`    | Add user to group       |\r\n| `ar`  | `rmfgroup`       | Remove user from group  |\r\n| `cn`  | `chname`         | Change username         |\r\n| `cs`  | `chshell`        | Change user shell       |\r\n| `luu` | `lockuser`       | Lock user account       |\r\n| `ulu` | `unlockuser`     | Unlock user account     |\r\n| `se`  | `setexp`         | Set account expiration  |\r\n| `re`  | `rmexp`          | Remove expiration       |\r\n| `uid` | `chuid`          | Change user ID          |\r\n| `lu`  | `listusers`      | List all users          |\r\n| `lug` | `listusergroups` | List user's groups      |\r\n| `hd`  | `homedir`        | Show home directory     |\r\n| `pi`  | `passinfo`       | Show password info      |\r\n| `ul`  | `userlocked`     | Check if locked         |\r\n| `ued` | `userexpday`     | Show expiration day     |\r\n| `idu` | `iduser`         | Show user ID info       |\r\n| `gu`  | `getentuser`     | Get user from system DB |\r\n| `h`   | `help`           | Help menu               |\r\n| `hf`  | `helpf`          | Full help               |\r\n| `q`   | `quit`           | Exit shell              |\r\n\r\n### 👥 Group Commands\r\n\r\n| Alias | Command      | Description                |\r\n| ----- | ------------ | -------------------------- |\r\n| `ga`  | `addgroup`   | Create new group           |\r\n| `gr`  | `rmgroup`    | Remove group (from system) |\r\n| `cg`  | `chgroup`    | Rename group               |\r\n| `gd`  | `delgroup`   | Delete group               |\r\n| `lg`  | `listgroups` | List all groups            |\r\n| `gid` | `chgid`      | Change group ID            |\r\n| `gi`  | `groupinfo`  | Show group info            |\r\n| `h`   | `help`       | Help menu                  |\r\n| `hf`  | `helpf`      | Full help                  |\r\n| `q`   | `quit`       | Exit shell                 |\r\n\r\n### 🔐 Permission Commands\r\n\r\n| Alias | Command    | Description             |\r\n| ----- | ---------- | ----------------------- |\r\n| `v`   | `view`     | View permissions        |\r\n| `c`   | `chmod`    | Change file permissions |\r\n| `co`  | `chown`    | Change file owner       |\r\n| `cg`  | `chgrp`    | Change group ownership  |\r\n| `au`  | `adduser`  | Add user permission     |\r\n| `ag`  | `addgroup` | Add group permission    |\r\n| `ru`  | `rmuser`   | Remove user permission  |\r\n| `rg`  | `rmgroup`  | Remove group permission |\r\n| `rc`  | `rchmod`   | Recursive chmod         |\r\n| `rco` | `rchown`   | Recursive chown         |\r\n| `rcg` | `rchgrp`   | Recursive chgrp         |\r\n| `h`   | `help`     | Help menu               |\r\n| `hf`  | `helpf`    | Full help               |\r\n| `q`   | `quit`     | Exit shell              |\r\n\r\n### 🔑 SSH Commands\r\n\r\n| Alias | Command    | Description         |\r\n| ----- | ---------- | ------------------- |\r\n| `i`   | `install`  | Install OpenSSH     |\r\n| `e`   | `enable`   | Enable SSH service  |\r\n| `gk`  | `genkey`   | Generate SSH key    |\r\n| `lk`  | `listkeys` | List SSH keys       |\r\n| `gh`  | `github`   | Setup GitHub SSH    |\r\n| `t`   | `test`     | Test SSH connection |\r\n| `s`   | `setup`    | Full SSH setup      |\r\n| `h`   | `help`     | Help menu           |\r\n| `hf`  | `helpf`    | Full help           |\r\n| `q`   | `quit`     | Exit shell          |\r\n\r\n### 📁 Samba Commands\r\n\r\n| Alias | Command       | Description            |\r\n| ----- | ------------- | ---------------------- |\r\n| `i`   | `install`     | Install Samba          |\r\n| `st`  | `start`       | Start Samba service    |\r\n| `sp`  | `stop`        | Stop Samba             |\r\n| `e`   | `enable`      | Enable Samba           |\r\n| `d`   | `disable`     | Disable Samba          |\r\n| `r`   | `restart`     | Restart Samba          |\r\n| `s`   | `status`      | Service status         |\r\n| `au`  | `adduser`     | Add Samba user         |\r\n| `ru`  | `removeuser`  | Remove Samba user      |\r\n| `eu`  | `enableuser`  | Enable Samba user      |\r\n| `du`  | `disableuser` | Disable Samba user     |\r\n| `ms`  | `mkshare`     | Create shared folder   |\r\n| `rs`  | `rmshare`     | Remove shared folder   |\r\n| `o`   | `owner`       | Set folder owner       |\r\n| `c`   | `chmod`       | Set folder permissions |\r\n| `ac`  | `addconfig`   | Add share config       |\r\n| `ls`  | `shares`      | List shares            |\r\n| `tc`  | `testconf`    | Test config            |\r\n| `con` | `connections` | Active connections     |\r\n| `p`   | `perms`       | Folder permissions     |\r\n| `f`   | `files`       | List shared files      |\r\n| `h`   | `help`        | Help menu              |\r\n| `hf`  | `helpf`       | Full help              |\r\n| `q`   | `quit`        | Exit shell             |\r\n\r\n### 🌐 Apache Commands\r\n\r\n| Alias | Command      | Description           |\r\n| ----- | ------------ | --------------------- |\r\n| `i`   | `install`    | Install Apache        |\r\n| `x`   | `extras`     | Install extra modules |\r\n| `st`  | `start`      | Start Apache          |\r\n| `sp`  | `stop`       | Stop Apache           |\r\n| `r`   | `restart`    | Restart Apache        |\r\n| `ss`  | `status`     | Check status          |\r\n| `ct`  | `configtest` | Test configuration    |\r\n| `ts`  | `testsite`   | Create test site      |\r\n| `vh`  | `vhost`      | Create virtual host   |\r\n| `en`  | `enable`     | Enable site           |\r\n| `di`  | `disable`    | Disable site          |\r\n| `al`  | `accesslog`  | View access log       |\r\n| `el`  | `errorlog`   | View error log        |\r\n| `h`   | `help`       | Help menu             |\r\n| `hf`  | `helpf`      | Full help             |\r\n| `q`   | `quit`       | Exit shell            |\r\n\r\n\u003c/details\u003e\r\n\r\n## Flags (run outside USYS):\r\n- `usys --version`  |   Show the installed version\r\n- `usys --update`   |   Check for updates and install if available\r\n- `usys --helpf`    |   Show full help message\r\n\r\n## Documentation and source code:\r\n[https://github.com/WattoX00/usys](https://github.com/WattoX00/usys)\r\n[https://pypi.org/project/usys/](https://pypi.org/project/usys/)\r\n\r\nIf you encounter any issues, please report them here:\r\n[https://github.com/WattoX00/usys/issues](https://github.com/WattoX00/usys/issues)\r\n\r\nThank you for using USYS!\r\n\r\n## ❤️ Support\r\n\r\nIf this project saved you time, taught you something, or made your day a little easier,\r\nyou can support its development here:\r\n\r\n👉 **[Buy me a coffee via PayPal](https://www.paypal.com/paypalme/wattox)**\r\n\r\nYour support helps keep the project:\r\n- Actively maintained\r\n- Continuously improved\r\n- Free and open source\r\n\r\nThanks for being part of the community 🤝\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwattox00%2Fusys","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwattox00%2Fusys","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwattox00%2Fusys/lists"}