Skip to content

xZepyx/Hypeman

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 

Repository files navigation

Hypeman

Hypeman is a minimal terminal tool that boosts your mood every time you open your terminal—showing a random motivational quote and ASCII/digital art.

Note:
This was a fun one-off project—no intention to compete with similar tools. Just a bit of CLI joy!

Status

📌 Project Discontinued

This project is no longer maintained as of <19 July 2025>.
Issues and PRs are closed. No new features or fixes will be added.

Why? --- "No time to maintain". Forks welcome: Feel free to fork and continue. Please link back to this repo.


✨ Features

  • Random motivational quote each launch
  • Rotating ASCII/digital art banners
  • Easily add your own quotes or art
  • No external dependencies (pure C++)
  • Fast, tiny, fully offline
  • Works with any shell: bash, zsh, fish
  • Open-source (MIT License)

💡 Why Hypeman?

I wanted a startup message that actually felt motivating—quotes from people I respect, art that doesn’t feel generic, and a CLI-native vibe.
If you spend hours in your terminal, a little positivity can go a long way!


🛠️ Installation

git clone https://github.com/Adityavihaan/Hypeman.git
cd Hypeman
./install.sh          # Builds and installs Hypeman to /usr/bin
./install-configs.sh  # Adds default quotes, art, and config files

🚀 Usage

hypeman

To run Hypeman every time you open a terminal, add this to your shell startup file:

For Bash:

echo "hypeman" >> ~/.bashrc

For Zsh:

echo "hypeman" >> ~/.zshrc

🎨 Customization

Add Your Own Art

Edit:

~/.config/hypeman/art.txt

Use this format:

art1 {
  ASCII ART LINES
}
art2 {
  MORE ART HERE
}
  • Each block is indented and labeled (art1, art2, ...).

Add or Edit Quotes

Edit:

~/.config/hypeman/quotes.txt
  • One quote per line.

Config Options

Edit:

~/.config/hypeman/config.toml

Options:

[style]
font = "default"        # Options: default, bold, small, block
color = "cyan"          # Options: red, green, yellow, blue, magenta, cyan, white

[settings]
randomize = true

📂 Config Files

All user data stored in:

~/.config/hypeman/
├── config.toml       # Style settings
├── quotes.txt        # Motivational quotes
└── art.txt           # Art blocks

🧹 Uninstall

sudo rm /usr/bin/hypeman
rm -rf ~/.config/hypeman

💭 Why Use It?

  • Personalizes your terminal
  • A small ritual for a mental boost
  • Offline, lightning fast
  • Infinitely extendable with your own personality

🤝 Contributing

Forks and PRs welcome—ideas too!

  • Random quote APIs
  • More color schemes
  • TUI version
  • Minimal mode / silent fallback
  • JSON support

📜 License

MIT — free to use, modify, share. Credit appreciated.


👤 Made By

Aditya (“xZepyx”), for anyone who calls their terminal home.

About

A terminal utility to Hype You

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published