Skip to content
Switch branches/tags
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

EmojiScreen 📺

A listing of movies, TV shows and musicals depicted through emojis.


Screenshot of Emojiscreen homepage

Contributing Guidelines 🎁

Below are some guidelines to follow when contributing to this project.

Adding or Updating Features Contributions

  • Find an Issue that you would like to complete or create an Issue if you have an idea for a new feature.
  • If someone is already assigned an Issue, please move on to another Issue. If the Issue has not been assigned, comment inside of the Issue stating that you would like to work on that item.
  • Wait for confirmation from the maintainers before working on the Issue.
  • After you receive confirmation, complete the Issue and submit a Pull Request.

If you would like to suggest a new feature, create an Issue and outline what it is you think should be added or updated. This project was created to help beginners, so any feature requests adding unessessary complexity to this project will not be accepted. Wait for confirmation before working on the Issue.

Adding a Movie, TV show or Musical

To add a show or movie to this project, you will need to first check the project in the movies.js, tv.js, or musicals.js files to make sure that the movie or show you would like to add is not already in the project. Once you confirm the item you want to add is not already in the project, you will add an Emoji Card inside of the movies.js, tv.js, or musicals.js files in the data folder. Each file is made up of an array (a list) of objects. You will add a new object for your show or movie into the appropriate file. Please note: The musicals.js file is for live musicals (such as Broadway and West End shows). Movie musicals should be added to the movies.js file.

If you need help choosing a movie or show, check the Issues.

Below is an example of what a show looks like on the website:

Screenshot of Beauty and the Beast Emoji Card

In the emoji javsacript files, each Emoji Card consists of the following object:

  title: "Beauty and the Beast",
  emojiImgs: "🏰🥀🎶📚🕰️",
  genres: ["animation", "family", "fantasy"],
  itemLink: "",
  type: "movie",
  year: 1991

Required reading:

View the Card Overview for details on each part of the emoji object.


Below are detailed walkthroughs on how to add a show or movie to EmojiScreen.

Important Notes

  • Follow all the instructions in the Card Overview for adding a show or movie.
  • Search the movies.js, tv.js, or musicals.js files and current open pull requests to make sure you are not adding a duplicate.
  • Make sure your emojis actually depict the show or movie. Someone should be able to guess what the show or movie is based on the emojis you choose.
  • If you are adding multiple items, please include them in one pull request.
  • Go through this checklist to make sure you have added everything needed for a show or movie.
  • Please fix conflicts if your pull request has them.

Git and GitHub Resources


💖Check out a list of all of the EmojiScreen contributors.

Emoji graphics are by Twitter and are licensed under CC-BY 4.0. Review the Attribution Requirements for more information.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.


EmojiScreen is a listing of movies, TV shows and musicals depicted through emojis.




No releases published


No packages published