https://github.com/shakir85/bashlogin
Bashrc login banner
https://github.com/shakir85/bashlogin
bash bashrc
Last synced: 3 months ago
JSON representation
Bashrc login banner
- Host: GitHub
- URL: https://github.com/shakir85/bashlogin
- Owner: shakir85
- Created: 2025-10-05T03:47:00.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2026-02-28T17:56:49.000Z (4 months ago)
- Last Synced: 2026-02-28T20:11:55.658Z (4 months ago)
- Topics: bash, bashrc
- Language: Shell
- Homepage:
- Size: 11.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Bash Login
A lightweight login banner for Bash that displays system information. It can be integrated with `.bashrc` to display helpful messages in an elegant way for the services you want. Useful on remote servers.
Default display at login:
- system information
- users sessions
Optional items
- show systemd service status (by supplying service names as args)
- customizable banner style via [Figlet](https://www.figlet.org) fonts
> [!NOTE]
> Figlet only detects fonts installed locally, typically located in: `/usr/share/figlet/`. Install additional fonts via your package manager or manually add `.flf` files to that directory.
## Usage
Clone the repository:
```bash
git clone https://github.com/tinycloud-labs/bashlogin.git ~/.config/bashlogin
```
Add this line to your `~/.bashrc`:
```bash
source "$HOME/.config/bashlogin/main.sh"
```
Reload your shell:
```bash
source ~/.bashrc
```
### Optional Configuration
In `~/.bashrc`, export `BASHLOGIN_ARGS`:
- [Optional] Use the `--style ` to use custom Figlet style
- Supply the service names (must be in systemd units)
Example:
```bash
BASHLOGIN_ARGS="--style big ssh docker k3s-agent"
```
> [!TIP]
> Note that `--style ` is not positional, it can be placed anywhere in the line