# Glance — Beautiful Self-Hosted Dashboard for All Your Feeds

> Glance is a self-hosted dashboard that puts RSS feeds, Reddit, YouTube, weather, stocks, GitHub releases, and more in one beautiful, customizable page.

## Install

Save the content below to `.claude/skills/` or append to your `CLAUDE.md`:

## Quick Use

```bash
docker run -d --name glance -p 8080:8080 
  -v ./glance.yml:/app/glance.yml 
  glanceapp/glance:latest
```

Create `glance.yml` configuration and open `http://localhost:8080`.

## Intro

**Glance** is a self-hosted dashboard that aggregates all your information feeds into a single, beautiful page. Built with Go, it's a fast, lightweight alternative to Heimdall, Homer, and Dashy, featuring RSS feeds, Reddit, Hacker News, YouTube, weather, stocks, GitHub releases, Twitch streams, and more — all configurable via a single YAML file.

With 33.2K+ GitHub stars and AGPL-3.0 license, Glance has rapidly gained popularity in the homelab community for its stunning design, minimal resource usage (~15MB RAM), and simple configuration.

## 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:

```yaml
# 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  # Veritasium
```

## Self-Hosting

### Docker Compose

```yaml
services:
  glance:
    image: glanceapp/glance:latest
    ports:
      - "8080:8080"
    volumes:
      - ./glance.yml:/app/glance.yml:ro
    restart: unless-stopped
```

### Binary (No Docker)

```bash
# Download single binary
curl -L https://github.com/glanceapp/glance/releases/latest/download/glance-linux-amd64 -o glance
chmod +x glance
./glance --config glance.yml
```

## Key Features

### Themes & Customization

Built-in themes with full CSS customization:

```yaml
theme:
  background-color: 20 20 30
  primary-color: 200 170 110
  contrast-multiplier: 1.2
  font-size-base: 16
```

### Multiple Pages

Organize widgets across multiple pages:
```yaml
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).

## Source & Thanks

- GitHub: [glanceapp/glance](https://github.com/glanceapp/glance) — 33.2K+ ⭐ | AGPL-3.0
- Docs: [github.com/glanceapp/glance/blob/main/docs](https://github.com/glanceapp/glance/blob/main/docs)

---
Source: https://tokrepo.com/en/workflows/glance-beautiful-self-hosted-dashboard-all-your-feeds-fcb05dd5
Author: Script Depot