Skip to main content

USYS – Linux User Manager

Version Python PyPI Status Build License

USYS is a simple command-line Linux user and group management tool. It provides an interactive interface to manage users and groups using clear commands and short aliases.

📚 Contents

Installation

pip install usys

[!IMPORTANT] usys is a terminal application. I recommend installing it with pipx.

Features

  • Create, modify, and delete users
  • Create and manage groups
  • Add users to groups
  • View user and group information
  • Simple command aliases for faster usage

Disclaimer:

This program may not always work as intended. Use it at your own risk, especially in production environments or large projects.

The program was primarily tested on Arch Linux. Other Linux distributions may behave differently.

Most operations require sudo permissions (except for listing functions), so make sure you understand what the program does before using it.

Usage:

Navigate between shells using their commands. For example, type 'user' or 'u' to enter the user shell mode. Inside each shell you can execute commands related to that category. Each shell also provides its own help functions.

Commands:

Click to open

📦 Root Commands

These commands switch you into dedicated management shells:

Alias Command Description
u user Enter user management shell
g group Enter group management shell
p permission Enter permission management shell
ss ssh Enter SSH setup shell
sa samba Enter Samba setup shell
a apache Enter Apache setup shell
h help Show root help menu
q exit Exit program

👤 User Commands

Alias Command Description
au adduser Create a new user
du deluser Delete a user
pw passwd Change user password
ag appendgroup Add user to group
ar rmfgroup Remove user from group
cn chname Change username
cs chshell Change user shell
luu lockuser Lock user account
ulu unlockuser Unlock user account
se setexp Set account expiration
re rmexp Remove expiration
uid chuid Change user ID
lu listusers List all users
lug listusergroups List user's groups
hd homedir Show home directory
pi passinfo Show password info
ul userlocked Check if locked
ued userexpday Show expiration day
idu iduser Show user ID info
gu getentuser Get user from system DB
h help Help menu
hf helpf Full help
q quit Exit shell

👥 Group Commands

Alias Command Description
ga addgroup Create new group
gr rmgroup Remove group (from system)
cg chgroup Rename group
gd delgroup Delete group
lg listgroups List all groups
gid chgid Change group ID
gi groupinfo Show group info
h help Help menu
hf helpf Full help
q quit Exit shell

🔐 Permission Commands

Alias Command Description
v view View permissions
c chmod Change file permissions
co chown Change file owner
cg chgrp Change group ownership
au adduser Add user permission
ag addgroup Add group permission
ru rmuser Remove user permission
rg rmgroup Remove group permission
rc rchmod Recursive chmod
rco rchown Recursive chown
rcg rchgrp Recursive chgrp
h help Help menu
hf helpf Full help
q quit Exit shell

🔑 SSH Commands

Alias Command Description
i install Install OpenSSH
e enable Enable SSH service
gk genkey Generate SSH key
lk listkeys List SSH keys
gh github Setup GitHub SSH
t test Test SSH connection
s setup Full SSH setup
h help Help menu
hf helpf Full help
q quit Exit shell

📁 Samba Commands

Alias Command Description
i install Install Samba
st start Start Samba service
sp stop Stop Samba
e enable Enable Samba
d disable Disable Samba
r restart Restart Samba
s status Service status
au adduser Add Samba user
ru removeuser Remove Samba user
eu enableuser Enable Samba user
du disableuser Disable Samba user
ms mkshare Create shared folder
rs rmshare Remove shared folder
o owner Set folder owner
c chmod Set folder permissions
ac addconfig Add share config
ls shares List shares
tc testconf Test config
con connections Active connections
p perms Folder permissions
f files List shared files
h help Help menu
hf helpf Full help
q quit Exit shell

🌐 Apache Commands

Alias Command Description
i install Install Apache
x extras Install extra modules
st start Start Apache
sp stop Stop Apache
r restart Restart Apache
ss status Check status
ct configtest Test configuration
ts testsite Create test site
vh vhost Create virtual host
en enable Enable site
di disable Disable site
al accesslog View access log
el errorlog View error log
h help Help menu
hf helpf Full help
q quit Exit shell

Flags (run outside USYS):

  • usys --version | Show the installed version
  • usys --update | Check for updates and install if available
  • usys --helpf | Show full help message

Documentation and source code:

https://github.com/WattoX00/usys https://pypi.org/project/usys/

If you encounter any issues, please report them here: https://github.com/WattoX00/usys/issues

Thank you for using USYS!

❤️ Support

If this project saved you time, taught you something, or made your day a little easier, you can support its development here:

👉 Buy me a coffee via PayPal

Your support helps keep the project:

  • Actively maintained
  • Continuously improved
  • Free and open source

Thanks for being part of the community 🤝

Release files for usys 0.1.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for usys 0.1.6
File Size Uploaded
usys-0.1.6.tar.gz 24.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for usys 0.1.6
File Interpreter ABI Platform
usys-0.1.6-py3-none-any.whl Python 3 none any Details

Total release size:51.1 kB

Release files / usys-0.1.6.tar.gz

Download URL usys-0.1.6.tar.gz
Size 24.5 kB
Tags Source
SHA-256 checksum
How to use checksums
6ace99e2cd9b1a0bfd79e1ab2878a85d75a82e0f155069d881b5e87351926b9a
BLAKE2b-256 checksum
How to use checksums
3a2d62c17553f22d6c7c0a640c2943b053c0c44b83fbf2c2ca466e3e380d3d2f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.12

Release files / usys-0.1.6-py3-none-any.whl

Download URL usys-0.1.6-py3-none-any.whl
Size 26.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c7203b7177ad89f720ea5ff3b6256834552d22afa2a2c96664971bf0bb6f3682
BLAKE2b-256 checksum
How to use checksums
2c36bdcd6f4424f3c9a68ba3b2a259ab32928c183c3262cd78076d58516b66ca
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.12

Release history Release notifications | RSS feed

This release

0.1.6 This release

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page