https://github.com/flohoss/godash
A simple, customizable dashboard written in Go. It provides an overview of weather information, system status, and bookmarks with icons and links.
https://github.com/flohoss/godash
bookmarks dashboard docker golang system weather
Last synced: about 2 months ago
JSON representation
A simple, customizable dashboard written in Go. It provides an overview of weather information, system status, and bookmarks with icons and links.
- Host: GitHub
- URL: https://github.com/flohoss/godash
- Owner: flohoss
- License: mit
- Created: 2025-03-03T21:59:27.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-04-02T09:16:55.000Z (4 months ago)
- Last Synced: 2026-04-03T00:18:21.075Z (4 months ago)
- Topics: bookmarks, dashboard, docker, golang, system, weather
- Language: Go
- Homepage:
- Size: 8.27 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GoDash
goDash is a simple, customizable dashboard written in Go. It provides an overview of weather information, system status, and bookmarks with icons and links.
# Table of Contents
- [GoDash](#godash)
- [Table of Contents](#table-of-contents)
- [Features](#features)
- [Screenshots](#screenshots)
- [Mobile](#mobile)
- [Desktop](#desktop)
- [Config](#config)
- [Docker](#docker)
- [run command](#run-command)
- [compose file](#compose-file)
- [✨ Star History](#-star-history)
- [License](#license)
- [Contributing](#contributing)
## Features
- Displays current weather
- Displays weather forcast for up to 6 days
- Shows system status and resource usage
- Provides quick access to bookmarks with icons and links
- Lightweight and easy to deploy with Docker
## Screenshots
### Mobile
### Desktop
## Config
At startup, godash will look for a `config.yaml` file in the current directory or create one. If it exists, it will be used to override the default values.
Icons can be stored in a folder called icons or godash will automatically download from [https://selfh.st/icons/](https://selfh.st/icons/) with the prefix `sh/`
```yaml
log_level: 'info' # Valid options: debug, info, warn, error
time_zone: 'Europe/Berlin' # Must be a valid IANA timezone (e.g., America/New_York, Europe/London)
title: 'My Dashboard' # Any string
server:
address: '0.0.0.0' # Valid IPv4 address, defaults to 0.0.0.0
port: 8156 # Optional, must be between 1024 and 65535, defaults to 8156
weather:
units: 'celsius' # Valid options: celsius, fahrenheit
latitude: 52.5163 # Optional, must be a valid latitude (-90 to 90)
longitude: 13.3776 # Optional, must be a valid longitude (-180 to 180)
applications:
- category: 'Productivity' # Any string
entries:
- name: 'Notion' # Any string
icon: 'notion.png' # File name or path for icon
ignore_dark: false # should not use the light icon even though it exists in dark mode
url: 'https://www.notion.so' # Optional, must be a valid URL
- name: 'Slack'
icon: 'sh/slack.svg' # Use self-hosted icons
ignore_dark: true
url: 'https://slack.com'
- category: 'Entertainment'
entries:
- name: 'YouTube'
icon: 'youtube.png'
ignore_dark: false
url: 'https://www.youtube.com'
- name: 'Spotify'
icon: 'spotify.png'
ignore_dark: false
url: 'https://www.spotify.com'
links:
- category: 'Work'
entries:
- name: 'GitHub'
url: 'https://github.com'
- name: 'Jira'
url: 'https://jira.com'
- category: 'Social'
entries:
- name: 'Twitter'
url: 'https://twitter.com'
- name: 'LinkedIn'
url: 'https://linkedin.com'
```
## Docker
### run command
```sh
docker run -d \
--name godash \
--restart always \
-v ./config:/app/config \
ghcr.io/flohoss/godash:latest
```
### compose file
```yaml
services:
godash:
restart: always
image: ghcr.io/flohoss/godash:latest
container_name: godash
volumes:
- ./config:/app/config
```
## ✨ Star History
## License
This project is licensed under the MIT License - see the [LICENSE](https://github.com/flohoss/godash/blob/main/LICENSE) file for details.
## Contributing
Feel free to open issues or submit pull requests to improve goDash!
---
## Development
### Automatic rebuild and reload
```sh
docker compose up
```
### Update Dependencies
```bash
# Node packages
docker compose run --rm yarn install --frozen-lockfile
docker compose run --rm yarn upgrade --latest
# Go packages
docker compose run --rm go get -u ./...
docker compose run --rm go mod tidy
```