Skip to content

About

Rate movies, series, games, books, anime and songs with your community and plan the next Party Night. A free, open source Root app (TypeScript, React, Node, SQLite).

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

🛋️ Couch Critics

Rate movies, series, games, books, anime and songs with your community, and plan the next movie night.

A free, open source Root app. Everyone rates, everyone sees the scores, and the group decides what to watch or play next.

License: MIT Latest release Last commit Root app TypeScript React

Features · Screenshots · What's new · Set it up · For developers · Changelog · Português

Couch Critics: the list of ratings

Couch Critics is an independent project. It is not an official Root app, and it is not sponsored, endorsed or certified by Root, TMDB, OMDb, IGDB, Twitch, Open Library, AniList or MusicBrainz. See NOTICE.md.

✨ Features

Rate together

  • Scores from 0 to 10 in half points, with an optional comment and an emoji picker. Two special ratings: Peak (counts as 10) and Rock Bottom (counts as 0)
  • One score per member per title. Every row shows the average, the IMDb rating and the first members' scores
  • Emoji reactions on other people's ratings, spoiler comments, and a score for each episode of a series or an anime

Find and add titles

  • Search with covers, synopsis and genres, in English or Portuguese: movies and series (TMDB), games (IGDB) and, optionally, books (Open Library), anime (AniList) and songs (MusicBrainz), which need no API key
  • Import your old ratings from a spreadsheet (CSV) and export them

Decide what's next

  • To watch / play: the group's list of everything someone wants to watch, play, read or listen to, with who wants each one. What you already finished goes to the end of your own list, under Done
  • Party Night: plan a movie or game night. Pick 2 to 8 titles, set a voting deadline, everyone votes (votes are public) and says if they are coming. The winner becomes a planned night, and Root notifications remind the ones who are going

Know your group

  • Who thinks like you, the titles that split the group, your year in ratings, the genres each person watched, and a Hall of Fame and Shame

Built for communities

  • English and Portuguese, light and dark themes (it follows the Root theme), narrow screens, and live updates for every member
  • Admins choose who configures the app, can remove comments and titles, and turn the optional categories on or off
  • No ads, no analytics and no tracking. The developer never sees a community's data

Every detail is in docs/features.md.

🖼️ Screenshots

Rate together

Ratings with comments and reactions
A score per member, with reactions
Emoji reactions on other people's ratings, and an optional comment with every score.

A spoiler comment hidden until clicked
Spoilers stay hidden
Mark a comment as spoiler and it only opens when someone clicks it.

Synopsis, genres and platforms
Synopsis, genres and platforms
In English or Portuguese, straight from the data sources.

Rating a series episode by episode
Series, episode by episode
An overall score and, if you want, one for each episode.

Find and add titles

Searching for a movie with covers
Search with covers
Movies, series, games, books, anime and songs, in English or Portuguese. Can't find it? Add it by hand.

The books category
Books, anime and songs
Optional categories that need no API key: the admin ticks them in Settings.

Importing ratings from a spreadsheet
Import your old ratings
Bring a CSV, check the matches, import. You can export yours too.

Decide what's next

The group's To watch / play list
To watch / play
What everyone wants to watch, play, read or listen to, with who wants each one. Done it already? It goes to the end of your own list.

A night with public votes
Party Night: vote and say if you're coming
Pick 2 to 8 titles, set a deadline, everyone votes (votes are public) and answers Going / Maybe / Not going.

Creating a new night
Anyone can plan a night
Name, date, voting deadline and titles from the community list.

A planned night
The winner becomes a planned night
Ties are broken by whoever created it. After the night, mark it as watched and rate it.

Know your group

Statistics: who thinks like you
Who thinks like you
Compatibility between members, the titles that split the group and how scores are spread.

A yearly recap
Your year in ratings
Scores given, average, favorites and the busiest month.

Hall of Fame and Shame
Hall of Fame and Shame
The titles with the most Peak and the most Rock Bottom ratings.

Looks good everywhere

The light theme
Light and dark
It follows the theme of your Root app.

On a phone
Made for narrow screens
The same app on a phone: ratings, the group's list and a night.

The screenshots use sample titles and made-up member names. Covers come from TMDB.

🆕 What's new

2.3.0: a new look, and every button takes you where it says (open panels close when you go to another category or view). 2.2.1: covers show up inside Root, the Songs category, and the night is now Party Night. 2.2.0: the To watch / play list and Party Night, to decide together what to watch or play. 2.0.1: the title list is paged, so it keeps working with hundreds of titles. 2.0.0: books, anime and songs, and import from a spreadsheet.

See the CHANGELOG and the releases. Click Watch → Custom → Releases on this page to be told about each new version.

🚀 Set it up

  1. Install Couch Critics in your Root community and choose, during the installation, who the app admins are. The community owner is always an admin.
  2. Admins open Settings and paste the free keys they need (TMDB for movies and series, OMDb for IMDb ratings, IGDB/Twitch for games). Books, anime and songs need no key. Without any key the app still works with titles added by hand.
  3. Everyone adds titles, rates, and plans nights.

Step-by-step guides: how to get the API keys and how to set them up. Each community uses its own free keys, and the app tells the admins when a service rejects one.

🧑‍💻 For developers

Couch Critics is built with the Root SDK: a TypeScript and React client, a Node.js server and SQLite storage.

npm install
npm run build
# dev host: put your dev token in server/.env (see server/.env.example), then
npm run server   # inside server/
npm run client   # inside client/

The development guide covers the project layout, the data sources, running it in the Root dev host, packaging and uploading your own version, and what to change if you fork it.

🤝 Feedback

Found a bug or have an idea? Open an issue. You can also message MalphasW on Root.

📄 License and credits

MIT. Third-party notices, and what the license does not cover (the app's name and logo and the TMDB logo), are in NOTICE.md. The privacy policy of the published app is in docs/privacy-policy.md.

Data and covers: TMDB, OMDb, IGDB (through Twitch), Open Library, AniList, MusicBrainz and the Cover Art Archive. This product uses the TMDB API but is not endorsed or certified by TMDB.

About

Rate movies, series, games, books, anime and songs with your community and plan the next Party Night. A free, open source Root app (TypeScript, React, Node, SQLite).

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages