steamfetch 0.2.1

neofetch for Steam - Display your Steam stats in terminal
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

# steamfetch

neofetch for Steam - Display your Steam stats in terminal.

## Screenshot

```
$ steamfetch

              .,,,,.                unhappychoice@Steam
        .'onNMMMMMNNnn',.           ─────────────────────
     .'oNMANKMMMMMMMMMMMNNn'.       Games: 486 (123 unplayed)
   .'ANMMMMMMMXKNNWWWPFFWNNMNn.     Playtime: 2,847h (118 days)
  ;NNMMMMMMMMMMNWW'' ,.., 'WMMM,    Perfect: 24 games
 ;NMMMMV+##+VNWWW' .+;'':+, 'WMW,   Achievements: 3,241 / 5,892 (55%)
,VNNWP+######+WW,  +:    :+, +MMM,
'+#############,   +.    ,+' +NMMM  Top Played
  '*#########*'     '*,,*' .+NMMMM  ├─ Borderlands 3      478h
     `'*###*'          ,.,;###+WNM  ├─ Coin Push RPG      377h
         .,;;,      .;##########+W  └─ DRG Survivor       252h
,',.         ';  ,+##############'
 '###+. :,. .,; ,###############'   Rarest: "Impossible Task" (0.1%)
  '####.. `'' .,###############'      in Dark Souls III
    '#####+++################'
      '*##################*'
         ''*##########*''
              ''''''
```

## Installation

```bash
cargo install steamfetch
```

## Usage

```bash
# Set your Steam API key
export STEAM_API_KEY="your_api_key"

# If Steam client is running: uses Steamworks SDK (accurate)
# If Steam client is not running: uses Web API (requires STEAM_ID)
export STEAM_ID="your_steam_id"

# Run
steamfetch

# Demo mode (no API key required)
steamfetch --demo
```

Get your API key at: https://steamcommunity.com/dev/apikey

Find your Steam ID at: https://steamid.io/

## Features

- [x] Display game count and playtime
- [x] Show achievement stats
- [x] Top played games
- [x] Rarest achievements
- [x] SteamOS ASCII art logo
- [x] Demo mode for testing
- [x] Steamworks SDK for accurate detection (auto-fallback to Web API)
- [ ] Custom color themes
- [ ] JSON output

## How It Works

### With Steam Client Running (Recommended)

Uses Steamworks SDK for accurate game detection:
- Checks ownership for all known Steam games (~73,000 titles)
- Accurate game count and achievement statistics

### Without Steam Client

Falls back to Steam Web API:
- Only returns games currently visible in your library
- Some owned games may not appear in the API response
- Requires `STEAM_ID` environment variable

## License

MIT