Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lacymorrow/cinematic
🎥 Gorgeous desktop movie collections
https://github.com/lacymorrow/cinematic
desktop electron genre meteor movie nodejs tmdb trailers
Last synced: 3 months ago
JSON representation
🎥 Gorgeous desktop movie collections
- Host: GitHub
- URL: https://github.com/lacymorrow/cinematic
- Owner: lacymorrow
- License: other
- Created: 2014-04-18T21:56:19.000Z (almost 11 years ago)
- Default Branch: main
- Last Pushed: 2024-04-11T15:49:16.000Z (10 months ago)
- Last Synced: 2024-04-13T21:01:38.356Z (10 months ago)
- Topics: desktop, electron, genre, meteor, movie, nodejs, tmdb, trailers
- Language: TypeScript
- Homepage: http://gh.lacymorrow.com/cinematic/
- Size: 640 MB
- Stars: 39
- Watchers: 5
- Forks: 5
- Open Issues: 31
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Cinematic 🎥
A gorgeous Desktop UI for your digital movie collection, powered by Electron and React. Works on Mac, Windows, and Linux!
[![Build Status][github-actions-status]][github-actions-url]
[![Github Tag][github-tag-image]][github-tag-url]
## ✨ Features
- 🎭 Filter movies by genre
- 🚥 Read plotlines and summaries before watching
- 🎬 Watch multiple trailers
- 🥃 Jump straight to the IMDB page
- 🍱 Keep track of recently viewed and watched movies
- 🍅 Cycle through ratings from IMDB, TMDB, and Metacritic
- ☔️ Network throttled requests to avoid timeouts
- 🐠 Built-in caching of genres and movies
- 🖇 Sort movies by name, popularity, release date, runtime, or randomly
- 🌙 Dark Mode support
- 🔄 Auto Updater
- 💾 Built-in Store with electron-store
- 🖱️ Context Menu
- ⌨️ Keyboard Shortcut Manager
- 🀱 Menu Bar for macOS, Windows, and Linux
- 🖥️ System Tray
[](https://github.com/lacymorrow/cinematic/releases)
### [Download for Windows, OSX, and Linux](https://github.com/lacymorrow/cinematic/releases)
Point Cinematic to the movie folder on your computer to scan and retrieve movie posters, ratings, trailers and much more about any movie files found.
Organize your movies by genre and sort by popularity, release date, runtime, or randomize things.
Cinematic prefers filenames like `Independence Day [1996].mp4` but will happily parse torrent-style `Movies.That.Look.Like.This.2015.HDRip.XviD.XXX-XXX.AVI`.
## 🚀 Getting Started
1. Clone this repository
```bash
git clone https://github.com/lacymorrow/cinematic.git
```
2. Go into the repository
```bash
cd cinematic
```
3. Install dependencies
```bash
yarn
```
4. Start the development server
```bash
yarn start
```
## 📁 Project Structure
- `src/main`: Contains the main process code
- `src/renderer`: Contains the renderer process code (React components)
- `src/config`: Contains configuration files
- `src/utils`: Contains utility functions
## 📜 Available Scripts
- `yarn start`: Start the app in development mode
- `yarn build`: Build the app for production
- `yarn lint`: Run the linter
- `yarn test`: Run tests
## Built With
- [Electron](https://electronjs.org/)
- [React](https://reactjs.org/)
- [React Router](https://reacttraining.com/react-router/)
- [Tailwind CSS](https://tailwindcss.com/)
- [Shadcn](https://ui.shadcn.com/)
- [TypeScript](https://www.typescriptlang.org/)
## Development
### Tailwind CSS
We use Tailwind CSS for styling. See the [Tailwind CSS docs](https://tailwindcss.com/docs) for more information.
Some Tailwind plugins have been added for convenience:
- [Tailwind Animate](https://github.com/jamiebuilds/tailwindcss-animate)
- [Tailwind Container Queries](https://github.com/tailwindlabs/tailwindcss-container-queries)
- Child selectors to target immediate children like `child:w-xl`
- Group selectors: `group` (Parent) `group-hover:bg-gray-100` (Child)
### Shadcn
Shadcn is a UI component library for React. See the [Shadcn docs](https://ui.shadcn.com/) for more information.
Use `npx shadcn-ui@latest add accordion ...` to add a component to your project.
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## 📄 License
This project is licensed under the CC-BY-NC-SA 4.0 License.
[github-actions-status]: https://github.com/lacymorrow/cinematic/workflows/Build/badge.svg
[github-actions-url]: https://github.com/lacymorrow/cinematic/actions
[github-tag-image]: https://img.shields.io/github/tag/lacymorrow/cinematic.svg?label=version
[github-tag-url]: https://github.com/lacymorrow/cinematic/releases/latest