CineCue - A seamless localization demo with RoR.

Syed Daanish — Mon, 28 Oct 2024 17:52:08 +0000

CineCue

CineCue is a demo Ruby on Rails web app that lets you explore movies by genre in multiple languages, all powered by Tolgee for seamless localization.

Nowadays, even with such advanced globalization we encounter a problem in distributing software across the globe - localization - As people from around the world speak different languages we need to create software that can be easily translated to increase our reach.

One of the best tools for this type of localization across multiple domains - web development, mobile application development, etc. - is tolgee.

This project is based on tolgee and is a demo for seamless localization with tolgee.

Screenshots

Features

Localized Movie Search: Find the perfect movie for any mood in one of seven languages: English, Turkish, Spanish, French, Arabic, Hindi, and Urdu.
Genre-Based Recommendations: Search and filter movies by genre for quick and relevant suggestions.
Tolgee Integration: Provides real-time localization, making CineCue accessible for global users.
User-Friendly Interface: Clean, responsive, and intuitive design for easy browsing.
Dynamic Content Updates: The latest movies and recommendations, refreshed for a tailored experience every time using the TMDb API.

Technologies Used

Ruby on Rails: The backbone of CineCue, enabling robust and scalable application development.
Tolgee: Open-source localization framework for streamlined translations and multi-language support.
TMDb API: Provides the latest movie data, enabling real-time genre-based recommendations and up-to-date information.

Installation

Clone the Repository: clone the tolgee repo and see the demo under the folder demos/CineCue
Install Dependancies:
```
bundle install
```
Set Up TMDb API Key:
- Sign up for an API key on The Movie Database (TMDb).
- Add the API key to the app/controllers/movies_controller.rb file in the @@api_key variable on the 6ᵗʰ line.
Set Up Tolgee API Key:
- Sign up for an API key on tolgee.io
- Start a new project and upload the .json files from the folder tolgee-json into the project.
- Add the API key to the app/controllers/application_controller.rb file in the api_key variable on the 11ᵗʰ line.
- Add the Project ID to the app/controllers/application_controller.rb file in the project_id variable on the 12ᵗʰ line.
Migrate Database:
```
rails db:migrate
```
Run the App:
```
rails server
```
Access the App:
- Open http://localhost:8080/ in your browser to start using CineCue!

PS: This is my first time working with open source projects and writing an article related to programming so I am open to being corrected if I could do anything better.