---
title: "pbl feed"
canonical_url: https://developer.repebble.com/pebbleos/docs/pbl/feed/
last_updated: 2026-10-21
sdk_version: 4.33.1
---
# pbl feed
Source: https://developer.repebble.com/pebbleos/docs/pbl/feed/
Write into the running emulator what the phone app would, over the Pebble protocol serial port, so features that depend on the phone can be exercised without one. Each kind of data is a subcommand:
```
pbl feed weather# a forecast for a few built-in citiespbl feed weather Tokyo Sydney --seed 3# a subset; the first is the current locationpbl feed weather --clear# remove every locationpbl feed music# a player and playlist; keeps serving until Ctrl-Cpbl feed music --title "Demo" --paused# a single track of your ownpbl feed calendar# a day of events around nowpbl feed calendar --title "Dentist" --start 15 --location "Downtown"pbl feed calendar --clear# remove every pinpbl feed notifications# a few messages from two senderspbl feed notifications --sender Anna --body "Lunch?" --app WhatsApp
pbl feed notifications --clear# remove every notification
```
`pbl feed --help` lists a feed’s own options. A feed that writes a database, like weather, exits once the data is stored. One that stands in for the phone, like music, keeps running: it acts on the watch’s controls, advances playback and draws album art when asked (album art is off by default, under Settings \> Music). The emulator’s port serves one host client at a time, so run one such feed at once.
The feeds live in `tools/libs/pbl-cli/pbl/feeds/`, one module per kind of data; [Extending pbl](https://developer.repebble.com/pebbleos/docs/pbl/extending.md) shows how to add one.
## Options
```
pbl feed [-h] [-b DIR] [--dry-run] [--host HOST] FEED ...
```
`calendar`
A day of calendar events
`music`
A music player and its playlist
`notifications`
A day of messages from a few senders
`weather`
A forecast for a few cities
`--host HOST`
host:port of the emulator’s Pebble protocol serial port (default: 127.0.0.1:12344)
Generated from PebbleOS [3a7b71785](https://github.com/coredevices/pebbleos/commit/3a7b71785fd439666c4a8bc116f561140e8dec01). This page is maintained in the pebbleos repository: [docs/pbl/feed.md](https://github.com/coredevices/pebbleos/blob/3a7b71785fd439666c4a8bc116f561140e8dec01/docs/pbl/feed.md).