Supreme Court Docket Watch Screensaver
The Supreme Court Docket Watch screensaver scrolls newly filed U.S. federal court opinions and filings, refreshed by a background pipeline from CourtListener's real legal-research API, using your free key. It's free, runs in your browser, and ESC exits.
How the Supreme Court Docket Watch screensaver works
A background pipeline queries CourtListener's API for recently filed federal court opinions, using your free key.
Each filing scrolls through with its real case name and court.
A running count tracks filings seen since the pipeline last refreshed.
Data refreshes on the pipeline's schedule, not live tick by tick.
Federal court records in the public docket
United States federal courts are organised in layers: district courts hear cases first, circuit courts of appeals review them, and the Supreme Court sits at the top. Court filings and opinions are public records, but they were historically hard to search. CourtListener, a project of the non-profit Free Law Project, gathers legal information from the courts and makes it searchable and available through APIs.
An opinion is a court’s written explanation of its ruling. Many are labelled as published and carry precedential weight, while others are unpublished and carry less. A case name in the list shows the parties, and the court identifier indicates which court issued the opinion. Lower courts decide far more cases than the Supreme Court does, so much of what appears comes from them.
The headline of a filing is not the verdict. Reading a case name tells you nothing about who won, whether the ruling was later appealed, or how broad its effect is. Coverage of CourtListener can also lag the courts themselves, so recent opinions may show up after a delay. This is a window onto public legal records, not legal analysis or advice.
A worked example
You might see a real recent opinion from a federal circuit court scroll past — genuine public court records, the same data legal researchers use.
Settings & tips
- Accent recolours the case names.
- Run
automation/run.py scotuswatchon your pipeline machine to refresh the data. - A free CourtListener API key is required — see the site's setup notes.
Frequently asked questions
- Why does it need a pipeline?
- CourtListener's API requires a free key, which stays on your pipeline machine and never reaches the browser.
- How do I get a key?
- Register for free at CourtListener.com — no cost, approval is usually immediate.
- Is this only the Supreme Court?
- No — it covers real federal court filings broadly, including circuit and district courts, not exclusively the Supreme Court.
- Is it free?
- Yes — free to use; only the pipeline's CourtListener key requires a free signup.
- What is the difference between a docket and an opinion?
- A docket is the running record of filings in a case, while an opinion is the court’s written decision. A case can have many docket entries and one or several opinions.
- Why do case names look like Smith v. Jones?
- The format lists the parties on each side of the dispute, separated by v. for versus.
- Are unpublished opinions less important?
- They often resolve routine matters and carry less precedential authority, though they still decide the case for the parties involved.