Skip to content

terminal-based dashboard, It shows your current time, weather, events, and even a motivational quote — all right inside your terminal.

License

Notifications You must be signed in to change notification settings

LordEaster/timeboard

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🕒 TimeBoard

TimeBoard is a beautiful, terminal-based dashboard written entirely in shell script. It shows your current time, weather, events, and even a motivational quote — all right inside your terminal.

✨ Be Simple but Outstanding – by @LordEaster | BSO Space

  _____ _                ____                      _ 
 |_   _(_)_ __ ___   ___| __ )  ___   __ _ _ __ __| |
   | | | | '_ ` _ \ / _ \  _ \ / _ \ / _` | '__/ _` |
   | | | | | | | | |  __/ |_) | (_) | (_| | | | (_| |
   |_| |_|_| |_| |_|\___|____/ \___/ \__,_|_|  \__,_|
                                                                             

🚀 Features

  • 🕒 Live clock with figlet display
  • 🌦 Real-time weather with condition, temperature, humidity
  • 📅 Upcoming Event (Coming soon)
  • 💬 Inspirational random quotes (Coming soon)
  • 🖥️ Fully terminal-based & portable
  • 🎨 Clean layout with interactive navigation

🧱 Project Structure

timeboard/
├── bin/
│   └── timeboard
├── modules/
│   ├── clock.sh
│   ├── dashboard.sh
│   ├── events.sh
│   ├── weather.sh
│   ├── help.sh
│   └── utils.sh
├── data/
│   └── events.json
├── setup/
│   └── boot.sh
├── Makefile
└── README.md

⚙️ Requirements

  • bash, curl, jq, figlet, tput

🛠️ Setup Instructions

# Clone the project
git clone https://github.com/LordEaster/timeboard.git
cd timeboard
# Make all scripts executable
chmod +x bin/timeboard modules/*.sh fetch_gcal_events.sh

# Run the dashboard
./bin/timeboard

Or use:

make install
make run

🖥️ Keyboard Shortcuts

Key Feature
c Clock
w Weather
e Events
h Help/About
i Back to Dashboard

📅 data/events.json format

[
  { "date": "2025-04-01", "title": "Project Deadline" },
  { "date": "2026-01-05", "title": "Yamroll's Birthday" }
]

✨ Credits

  • wttr.in for weather
  • figlet, jq, and bash for CLI magic

🧑‍💻 Author

Built with ❤️ by @LordEaster
🎓 BSO Space | TimeBoard Project
"Be Simple but Outstanding"

About

terminal-based dashboard, It shows your current time, weather, events, and even a motivational quote — all right inside your terminal.

Resources

License

Stars

Watchers

Forks

Packages

No packages published