Japanese Dictionary & Kanji Learning Platform

A modern, offline-first Japanese learning desktop application built with JavaFX, SQLite, and Maven. Designed for fast Kanji lookup, structured study, and cross-platform compatibility without requiring an internet connection.

---

✨ Features

• 🔍 Instant Kanji lookup
• 🇬🇧 Search Kanji using English meanings
• ⭐ Bookmark favorite Kanji
• 📚 Bookmark and organize frequently used Kanji
• 🈶 Display Onyomi, Kunyomi, stroke count, meanings, and related Kanji
• 🌙 Dark & Light theme support
• ⚡ Fast local database with zero network dependency
• 💻 Native support for Windows and Linux
• 📦 Offline-first architecture

---

📸 Screenshots

---

🎯 Why I Built This

As someone learning Japanese and preparing for the JLPT N5, I wanted a lightweight, distraction-free dictionary that worked entirely offline.

Most available solutions were either web-based, mobile-focused, or required a constant internet connection. I built this application to provide a fast, cross-platform desktop experience for studying Kanji efficiently on both Windows and Linux.

---

🏗 Architecture

The application follows the Model–View–Controller (MVC) architecture, making the codebase modular, maintainable, and easier to extend as new features are added.

User
   │
JavaFX UI
   │
Controller
   │
SQLite Database (JDBC)

---

🚀 Performance

Because all data is stored locally in SQLite, the application offers:

• ⚡ Near-instant search results
• 📶 No internet connection required
• 💾 Low memory usage
• 🚀 Fast application startup
• 🔒 Complete offline functionality

---

🛠 Technology Stack

Category	Technology
Language	Java
UI Framework	JavaFX
Database	SQLite
Database Access	JDBC
Build Tool	Maven
UI Theme	AtlantaFX

---

📂 Project Structure

src/
├── model/
├── controller/
├── database/
├── ui/
├── utils/
└── resources/

---

📦 Installation

Windows

1. Download the latest .msi installer from the Releases page.
2. Run the installer.
3. Follow the installation wizard.
4. Launch the application from the Start Menu.

---

Linux (Debian / Ubuntu)

Download the latest .deb package from the Releases page.

Install it using:

sudo dpkg -i japanesedictionary_1.0_amd64.deb

If any dependencies are missing:

sudo apt install -f

Launch the application:

japanesedictionary

---

💻 Building From Source

Requirements

• BellSoft Liberica JDK (Full Edition)
• Maven

Clone the repository:

git clone https://github.com/SuperAnand67/Japanese-Dictionary-JavaFX.git

Navigate to the project directory:

cd Japanese-Dictionary-JavaFX

Build the project:

mvn clean package

Run the application:

mvn javafx:run

---

💾 Database

The application automatically creates and manages its SQLite database inside the user's local application directory during installation.

No manual configuration is required.

---

🛣 Roadmap

✅ Completed

• Offline Kanji Dictionary
• English Meaning Search
• Bookmark System
• Dark / Light Theme
• Native Windows Installer
• Native Linux Package
• Maven Migration
• MVC Refactoring
• Cross-platform Support

🚧 Planned

• Search by Radical (部首)
• JLPT Vocabulary Lists
• Example Sentences
• Furigana Support
• Flashcards
• Search History
• Import / Export Bookmarks
• Audio Pronunciation
• Stroke Order Animations

---

🤝 Contributing

Contributions, feature requests, bug reports, and suggestions are welcome.

1. Fork the repository.
2. Create a new feature branch.
3. Commit your changes.
4. Push your branch.
5. Open a Pull Request.

---

📄 License

This project is licensed under the MIT License.

Feel free to use, modify, and distribute it in accordance with the license terms.