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

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 🤝

Metadata

Release files for usys 0.1.7

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.7
File Size Uploaded Provenance Actions
usys-0.1.7.tar.gz 25.1 kB Without provenance Details for usys-0.1.7.tar.gz

Built distribution (wheel)

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

Total release size: 52.0 kB

Release files / usys-0.1.7.tar.gz

Download URL usys-0.1.7.tar.gz
Size 25.1 kB
Tags Source
SHA-256 checksum
How to use checksums
6554fd5c447f1f770235b5cf21fbf4f902ab90c42058896d3dbeeeca9d4ac246
BLAKE2b-256 checksum
How to use checksums
fb41ed73c804d60906473b3910c1b91e023530082827b21af103f462e1349fd5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

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

Download URL usys-0.1.7-py3-none-any.whl
Size 26.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
876654f2000d8f5b67d114a9e5e253719e6cc20de07471681f99d1d62545b58d
BLAKE2b-256 checksum
How to use checksums
f09ea5656a40b5d5f678710f8a22ed6ac8997584aa4c53c676dab90fa6d3a906
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Security for usys 0.1.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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