Skip to content

Home

Jump to bottom
Eric edited this page Dec 19, 2025 · 2 revisions

📊 Terminal Dashboard Wiki

Welcome to the Terminal Dashboard project wiki.
This dashboard is a Python-based terminal application that combines weather forecasts and banking overviews into a single, interactive, and customizable interface using the Rich library.

This wiki documents the architecture, setup, features, and usage of the project.

🚀 Project Overview

The Terminal Dashboard allows users to:

  • View hourly and weekly weather forecasts for any city
  • Automatically resolve locations to coordinates
  • Load and analyze bank CSV statements
  • Display financial summaries and transaction history
  • Customize the terminal appearance using selectable themes

The goal of this project is to demonstrate:

  • Clean Python structure
  • API integration
  • Terminal UI design
  • Data parsing and visualization
  • Error handling and user interaction

🧩 Features

🌦 Weather Module

  • City-based weather lookup
  • Hourly forecast
  • Weekly forecast
  • Weather icons and descriptions
  • Wind speed and temperature display

💰 Banking Module

  • Automatic detection of the newest CSV file
  • Calculation of:
    • Total expenses
    • Total income
    • Account balance
  • Full transaction table rendered in the terminal

🎨 Theme System

  • Multiple predefined themes:
    • Classic
    • Midnight
    • Forest
    • Sunset
    • High Contrast
  • Live preview before applying a theme
  • Centralized style management

🛠 Technologies Used

  • Python 3
  • Rich (Layout, Table, Panel, Theme)
  • OpenWeather API
  • Geoapify API
  • Requests
  • PyFiglet
  • CSV module

📁 Project Structure

project-root/ │ ├── 02_Bankauszüge/ # Bank CSV statements ├── requirements/ # API keys and configuration │ └── apikey.py ├── dashboard.py # Main application ├── README.md ├── SECURITY.md └── wiki/

⚙️ Getting Started

  1. Clone the repository
  2. Insert your API keys for:
    • OpenWeather
    • Geoapify
  3. Add bank CSV files to 02_Bankauszüge/
  4. Run the dashboard script
  5. Choose a theme and enter a city

📚 Wiki Sections

Recommended pages for this wiki:

  • Installation
  • Configuration
  • Weather API
  • Banking CSV Format
  • Theme System
  • Error Handling
  • Known Limitations
  • Future Improvements

⚠️ Disclaimer

This project is intended for educational and local use only.
It is not suitable for production environments or handling sensitive data without additional security measures.

Clone this wiki locally