Skip to content

jjf3/rewindOS_sfa_StarTrekSub_Tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Star Trek: Starfleet Academy — Fandom & Canon Tracker

(r/startrek + r/DaystromInstitute)

A lightweight Python project for measuring deep fandom and analytical engagement around Star Trek: Starfleet Academy on Reddit by tracking discussion behavior, not subscriber counts.

This tracker is intentionally scoped to Star Trek–specific subreddits, where conversation reflects canon interpretation, science analysis, and sustained episode-to-episode engagement rather than general audience reaction or industry news.


What This Project Does

This tracker captures how committed Star Trek fans and analysts engage with Starfleet Academy over time, rather than how widely the show is noticed.

Specifically, it:

  • Searches r/startrek and r/DaystromInstitute for posts related to Star Trek: Starfleet Academy

  • Identifies and classifies posts into:

    • episode discussion threads (e.g. 1x03, S01E01, Episode 4)
    • official trailers and teasers
    • high-engagement non-episode posts (canon debates, theory posts, science analysis)
  • Captures post-level metadata:

    • comment count
    • score (net upvotes)
    • creation timestamp
    • subreddit source
  • Appends comment counts to a time-series dataset on each run

  • Generates:

    • CSV exports for structured analysis
    • line graphs showing comment growth over time
    • a local, static HTML dashboard for review

The result is a reproducible way to observe how Starfleet Academy is interpreted, debated, and contextualized within Star Trek fandom, rather than how it performs as a mass-market release.


What This Tracker Is Designed to Show

Early runs consistently highlight that Star Trek–specific subreddits behave very differently from r/television:

  • Episode discussion is more structured and sustained

  • Comments skew toward:

    • canon consistency
    • continuity placement
    • in-universe logic and science
  • Engagement persists beyond premieres and trailers

  • DaystromInstitute posts trade volume for depth and analytical rigor

This tracker treats that behavior as the primary signal, rather than noise.


Why Two Subreddits

This project intentionally combines two complementary fandom spaces:

r/startrek

  • Broad fandom discussion
  • Episode reactions and speculation
  • Higher volume, mixed sentiment

r/DaystromInstitute

  • Canon-first analysis
  • Hard science and continuity reasoning
  • Lower volume, higher signal-to-noise ratio

Tracking both together allows you to distinguish:

  • emotional fandom response vs
  • intellectual and analytical engagement

without flattening them into a single metric.


Why Comments Instead of Subscribers

Reddit’s visible subscriber and “active user” counts vary by:

  • interface
  • aggregation context
  • subreddit rules and visibility

They are unreliable for longitudinal analysis.

Comments, by contrast:

  • represent deliberate participation
  • accumulate over time
  • reflect disagreement as well as approval
  • remain accessible via public JSON endpoints

For fandom and canon analysis, comment growth is a stronger indicator of sustained engagement than subscriber totals alone.


Project Structure

starfleet_academy_fandom_tracker/
├─ src/
│  └─ show_reddit_tracker.py
│
├─ data/
│  └─ starfleet_academy_comment_history.csv
│
├─ out/
│  ├─ starfleet_academy_all_posts.csv
│  ├─ starfleet_academy_episode_posts.csv
│  ├─ starfleet_academy_selected_posts.csv
│  ├─ starfleet_academy_episode_comment_growth.png
│  ├─ starfleet_academy_non_episode_comment_growth.png
│  └─ dashboard_starfleet_academy.html
│
├─ logs/
│  └─ starfleet_academy_tracker.log
│
├─ README.md
├─ requirements.txt
└─ .gitignore

Requirements

  • Python 3.11 or newer

Install dependencies with:

pip install -r requirements.txt

How to Run

Set environment variables (example for PowerShell):

$env:SHOW_SLUG="starfleet_academy"
$env:SHOW_NAME="Starfleet Academy"
$env:SUBREDDITS="startrek,DaystromInstitute"
$env:QUERY_TERMS='"Starfleet Academy",Academy,SFA'
python src/show_reddit_tracker.py

The script will:

  • fetch current Reddit data
  • append to the comment history file
  • regenerate CSVs, plots, and the HTML dashboard

Open the dashboard locally:

out/dashboard_starfleet_academy.html

(No web server required.)


Notes on Data Use

  • Uses only Reddit’s public JSON search endpoints
  • No API keys or authentication required
  • Designed for infrequent polling (6–12 hours recommended)
  • Comment trends become meaningful over repeated runs
  • Low post volume in DaystromInstitute is treated as a signal of depth, not a failure

Relationship to Other Trackers

This tracker is part of a layered approach to measuring Starfleet Academy’s cultural footprint.

  • r/television tracker → general audience & industry sentiment
  • r/startrek + DaystromInstitute tracker → fandom depth & canon engagement

Together, they separate visibility from commitment, avoiding misleading aggregate metrics.


Part of the RewindOS project — tracking cultural and fandom signals where traditional audience metrics fall short.

About

A Python project for measuring active fandom engagement on various Star Trek Subs for Star Trek Starfleet Academy

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors