world.treeline.activity.record

A sports activity or outdoor adventure record logged on Treeline.

Repository @treeline.world did:plc:sjejpugpajgvxweilujzjcmq namespace authority
Details · record, key tid
Kindrecord
Record keytid
Authorityactivity.treeline.world
Indexed

Showing version bafyreiemify3da6vxap464sidg6mk4rl67yfjamiajnzmoe6c4q2ayndbi. Show the latest

Record

record · key tid

Properties

Optional reference to the activity this record was saved from (Save as My Activity). The AppView checks the source's reuse rules at index time and hides this record's geometry and co-athlete link when they are not met.

DIDs of athletes who participated in this activity together.

  • maxLength: 50
itemsstring · did

createdAt

requiredstring · datetime

Record creation timestamp on client/PDS (ISO 8601 UTC format).

Detailed notes, trip report, weather observations, or gear notes.

  • maxLength: 30000
  • maxGraphemes: 3000

Recording hardware or sensor device metadata.

Reference

endedAt

string · datetime

Timestamp when the activity finished (ISO 8601 UTC format).

Optional reference to a world.treeline.gear.item used in this activity.

Simplified GeoJSON LineString path (recommended <= 250 points) for lightweight relay and feed distribution.

Reference

Displaced privacy discs (at most 2: start and end, or 1 shared disc on a loop) used to trim the public preview geometry and prevent start/end triangulation. The original telemetry blob remains untrimmed.

  • maxLength: 2
itemsref
Reference

When true, AppViews must not show heart rate, power, cadence or energy stats to anyone but the owner. Presentation only: the original telemetry blob remains untouched and publicly retrievable.

  • default: false

Distance trimmed from each end of the public preview only. The original telemetry blob remains untrimmed and publicly retrievable.

  • minimum: 0
  • maximum: 100000

labels

union

Optional self-label values the author applies to this record, effectively content warnings (e.g. graphic-media for an injury photo).

langs

array

Optional. The human languages of this record's text (the title, description and photo alt text), as BCP-47 tags, so consumers can filter or translate.

  • maxLength: 3
itemsstring · language

photos

array

Photos taken during the activity, in display order. Each item is field-compatible with app.bsky.embed.images#image (image, alt, aspectRatio), so clients can embed them in a Bluesky post without re-uploading. Clients must strip all EXIF metadata from the image blob before upload.

  • maxLength: 8
itemsref
Reference

privacy

string

AppView visibility, not confidentiality of the public repository or original blob. New clients publish public or unlisted; unsupported restricted values must fail closed.

  • default: "public"
  • knownValues: public | unlisted | followers | private | permissioned

Full-resolution original raw telemetry file (.fit, .gpx, .tcx) stored directly as an ATProto blob on the athlete's PDS.

  • maxSize: 52428800
  • accept: application/gpx+xml, application/vnd.ant.fit, application/vnd.garmin.tcx+xml, application/octet-stream, application/xml, text/xml

Optional reference to a world.treeline.route.record course or trail guide followed.

Optional reference to a world.treeline.route.record followed.

sport

requiredstring

Sport or activity type category.

  • knownValues: run | trail_run | walk | hike | ride | mountain_bike | gravel_ride | e_bike | road_bike | handcycle | ski | snowboard | backcountry_ski | nordic_ski | roller_ski | swim | open_water_swim | kayak | canoe | rowing | paddleboard | surf | kitesurf | windsurf | sail | climb | boulder | mountaineering | wheelchair | workout | yoga | crossfit | weight_training | pilates | hiit | other

startedAt

requiredstring · datetime

Timestamp when the activity started (ISO 8601 UTC format).

Summary metrics and telemetry statistics for the activity.

Reference

tags

array

Categorization tags (e.g. race, commute, intervals, summits).

  • maxLength: 20
itemsstring
  • maxLength: 64

timezone

string

IANA time zone name (e.g. 'America/Denver', 'Europe/Paris').

  • maxLength: 64

title

requiredstring

Display title of the activity (e.g., Morning Trail Run, Grand Canyon R2R2R).

  • maxLength: 3000
  • maxGraphemes: 300

Local time zone offset from UTC in minutes (-840 to +840).

  • minimum: -840
  • maximum: 840

#aspectRatio

object

Width and height of the image in any unit; only the ratio matters. Same shape as app.bsky.embed.defs#aspectRatio.

Properties

height

requiredinteger
  • minimum: 1

width

requiredinteger
  • minimum: 1

#deviceMetadata

object

Metadata about the recording hardware or sensor device.

Properties

Manufacturer name (e.g. Garmin, Wahoo, COROS, Apple).

  • maxLength: 100

model

string

Device model name (e.g. Forerunner 965, ELEMNT BOLT, Apple Watch Ultra).

  • maxLength: 100

#geometry

object

Simplified GeoJSON LineString geometry representing the activity path.

Properties

coordinates

requiredarray

RDP-simplified array of coordinate tuples [lon, lat, ele?].

  • maxLength: 500
itemsarray
itemsstring

type

requiredstring

GeoJSON geometry type specifier.

  • const: "LineString"

#hiddenArea

object

A displaced circular privacy zone used to trim public preview geometry.

Properties

center

requiredarray

Displaced disc centre as decimal-string [longitude, latitude].

  • minLength: 2
  • maxLength: 2
itemsstring
  • maxLength: 32

radiusMeters

requiredinteger

Disc radius R = r + D in meters.

  • minimum: 1
  • maximum: 200000

#photo

object

A photo attached to an activity. image, alt and aspectRatio match app.bsky.embed.images#image field for field; caption, takenAt and position are Treeline additions that other AppViews may ignore.

Properties

alt

requiredstring

Alt text for screen readers and Bluesky embeds. May be empty, as on app.bsky.embed.images#image.

  • maxLength: 10000
  • maxGraphemes: 1000
Reference

caption

string

Optional visible caption shown with the photo.

  • maxLength: 3000
  • maxGraphemes: 300

image

requiredblob

The photo, re-encoded by the client with all EXIF metadata removed. Same size limit as app.bsky.embed.images#image.

  • maxSize: 1000000
  • accept: image/jpeg, image/png, image/webp

Where the photo sits on the route, as decimal-string [longitude, latitude]. Clients omit it for photos inside hideStartEndMeters or hiddenAreas, and AppViews must not show it publicly there.

  • minLength: 2
  • maxLength: 2
itemsstring
  • maxLength: 32

takenAt

string · datetime

When the photo was taken (ISO 8601 UTC), used to order photos along the activity timeline.

#stats

object

Summary telemetry metrics calculated from the raw activity dataset.

Properties

[Deprecated: use avgCadence] Average cadence in rpm or spm.

  • minimum: 0

[Deprecated: use avgHeartRateBpm] Average heart rate in beats per minute.

  • minimum: 0
  • maximum: 300

[Deprecated: use avgPowerWatts] Average power output in watts.

  • minimum: 0

[Deprecated: use avgSpeedMps] Average moving speed in meters per second.

avgCadence

integer

Mean cadence (rpm or spm).

  • minimum: 0

Mean cadence in revolutions or steps per minute.

  • minimum: 0

Mean heart rate in beats per minute.

  • minimum: 0
  • maximum: 300

Mean power output in watts from a recorded sensor.

  • minimum: 0

Calculated mean moving speed in meters per second.

calories

integer

Estimated energy expenditure in kilocalories.

  • minimum: 0

Total distance traveled in meters.

  • minimum: 0

[Deprecated: use elapsedDurationSeconds] Total elapsed time in seconds.

  • minimum: 0

Total elapsed time including pauses in seconds.

  • minimum: 0

Cumulative elevation gain in meters.

  • minimum: 0

Cumulative elevation loss in meters.

  • minimum: 0

Total mechanical work in kilojoules (session.total_work or avgPowerWatts * movingDurationSeconds / 1000).

  • minimum: 0

Maximum recorded heart rate in beats per minute.

  • minimum: 0
  • maximum: 300

Maximum power output in watts.

  • minimum: 0

Maximum recorded speed in meters per second.

Active moving duration excluding pauses in seconds.

  • minimum: 0

[Deprecated: use movingDurationSeconds] Total moving time excluding pauses in seconds.

  • minimum: 0

Average ambient temperature in degrees Celsius.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • PROVISIONAL: activities are generic enough that they belong in a community-driven lexicon rather than an app namespace. When a community schema stabilizes, Kimbia will migrate to it and deprecate this one in its favor.

  • One private GPS activity. Distance, duration, and elevation are derived by the app from the uploaded route file.

  • A recorded physical activity such as a bike ride.

  • A recording of an activity. Like running, walking, lifting weights, etc. Helpful to create the rkey tid from the start time and clock id 23 so you can upsert easily.

  • A cycling, running, hiking, walking, etc. route shared by a user. The associated track file is stored as a blob.