Skip to content

joshndala/third-act

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

18 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

The Third Act 🎬

A visually rich, cinematic movie journaling experience. Capture how films make you feel, tracked beautifully.

↓ Download for macOS


This project consists of two main components:

  1. Desktop App β€” The core JavaFX application for journaling and tracking.
  2. Landing Page β€” A modern Vue.js marketing site.

πŸ’» Desktop Application

A local-first, privacy-focused movie journal with AI-powered features.

Features

  • Cinematic Dashboard β€” High-res backdrop cards with gradient overlays.
  • AI-Powered Archiving β€” Import handwritten notes via Gemini 2.0 Flash (OCR & summarization). Upload directly from your mobile device via a local network QR code.
  • Movie Search β€” Powered by TMDb for metadata and high-res assets.
  • Customizable Appearance β€” Switch between brand Navy (Dark) and Cream (Light) themes.
  • Local & Private β€” All data stays on your machine in a SQLite database.

Tech Stack

  • Java 19 & JavaFX 19 (pure code, no FXML)
  • SQLite for local storage
  • Gemini API (Google AI) for note analysis
  • TMDb API for movie intelligence
  • Maven for dependencies

🎨 Brand Palette

  • Navy #2B3358 (Primary/Dark Mode)
  • Gold #D4A15C (Accent)
  • Cream #F5F2E9 (Background/Light Mode)

πŸš€ Getting Started

Prerequisites

  • JDK 19+
  • Maven 3.8+
  • Node.js 18+

1. Setup API Keys

Create a .env file in desktop-app/:

TMDB_API_KEY=your_tmdb_key
GEMINI_API_KEY=your_gemini_key

2. Run the Desktop App

cd desktop-app
mvn javafx:run

3. Run the Landing Page

cd landing-page
npm install
npm run dev

πŸ“‚ Project Structure

third-act/
β”œβ”€β”€ desktop-app/      # JavaFX application source
β”œβ”€β”€ landing-page/     # Vue.js marketing site
└── assets/           # Shared brand assets & icons

License

MIT