What Glance Does
Glance provides configurable widgets for:
- RSS Feeds: Any RSS/Atom feed with thumbnails and summaries
- Reddit: Subreddit posts with thumbnails and engagement metrics
- Hacker News: Top stories, new, best, ask, and show
- YouTube: Channel videos with thumbnails
- Weather: Current conditions and forecast (via Open-Meteo)
- Stocks/Crypto: Real-time market data for any ticker
- GitHub Releases: Latest releases from any repository
- Twitch: Live streams and channel status
- Calendar: iCal/webcal integration
- Bookmarks: Quick link collections
- Search: Custom search widget with multiple engines
- Clock: Multiple time zones
- Custom Iframe: Embed any web page or service
- Monitor: HTTP endpoint health checks
Configuration
Everything in a single YAML file:
# glance.yml
pages:
- name: Home
columns:
- size: small
widgets:
- type: weather
location: Shanghai, China
units: metric
- type: bookmarks
groups:
- title: Dev Tools
links:
- title: GitHub
url: https://github.com
- title: GitLab
url: https://gitlab.com
- type: stocks
stocks:
- symbol: AAPL
- symbol: GOOG
- symbol: BTC-USD
- size: full
widgets:
- type: rss
title: Tech News
style: horizontal-cards
feeds:
- url: https://hnrss.org/frontpage
title: Hacker News
- url: https://www.theverge.com/rss/index.xml
title: The Verge
- type: reddit
subreddit: selfhosted
show-thumbnails: true
- size: small
widgets:
- type: releases
repositories:
- immich-app/immich
- jellyfin/jellyfin
- glanceapp/glance
- type: youtube
channels:
- UCHnyfMqiRRG1u-2MsSQLbXA # VeritasiumSelf-Hosting
Docker Compose
services:
glance:
image: glanceapp/glance:latest
ports:
- "8080:8080"
volumes:
- ./glance.yml:/app/glance.yml:ro
restart: unless-stoppedBinary (No Docker)
# Download single binary
curl -L https://github.com/glanceapp/glance/releases/latest/download/glance-linux-amd64 -o glance
chmod +x glance
./glance --config glance.ymlKey Features
Themes & Customization
Built-in themes with full CSS customization:
theme:
background-color: 20 20 30
primary-color: 200 170 110
contrast-multiplier: 1.2
font-size-base: 16Multiple Pages
Organize widgets across multiple pages:
pages:
- name: Home
# main dashboard widgets...
- name: Development
# dev-focused widgets...
- name: Finance
# stock & crypto widgets...Responsive Layout
Glance automatically adjusts layout for mobile, tablet, and desktop viewports.
Resource Usage
- RAM: ~15MB idle
- CPU: Negligible
- Docker image: ~15MB
- Startup time: <1 second
Glance vs Alternatives
| Feature | Glance | Homer | Dashy | Heimdall |
|---|---|---|---|---|
| Config | YAML file | YAML | YAML/UI | Web UI |
| RSS Feeds | Built-in | No | Plugin | No |
| Reddit/HN | Built-in | No | No | No |
| Weather | Built-in | No | Widget | No |
| Stocks | Built-in | No | Widget | No |
| Themes | CSS + built-in | Limited | 50+ | Limited |
| RAM usage | ~15MB | ~5MB | ~150MB | ~100MB |
| Docker size | ~15MB | ~10MB | ~200MB | ~150MB |
FAQ
Q: How is Glance different from Homer/Dashy? A: Homer and Dashy are mainly app-link dashboards (bookmark pages). Glance is an information-aggregation dashboard with built-in widgets for RSS, Reddit, weather, stocks, and other live content. If you only need app links, Homer is simpler. If you want news, updates, and data at a glance, Glance is a better fit.
Q: Can I customize CSS? A: Yes. Glance supports YAML-configured color themes and custom CSS files for deeper customization.
Q: Authentication support? A: Glance has no built-in authentication. Protect access via a reverse proxy's basic auth (Nginx, Caddy, Traefik) or an OAuth proxy (Authelia, Authentik).