Repository navigation
v1.0.0
π OpenccJavaFX v1.0.0
We are excited to announce the first stable release of OpenccJavaFX v1.0.0, a cross-platform JavaFX application and CLI for Simplified β Traditional Chinese conversion, powered by OpenccJava.
This release provides both a GUI (JavaFX desktop app) and CLI (command-line tool), packaged together with all required runtime libraries and dictionaries.
π¦ Distribution Contents
The provided distZip archive unpacks into:
OPENCCJAVAFX-1.0.0
ββ bin
β ββ openccjava-cli # Unix shell launcher (CLI)
β ββ openccjava-cli.bat # Windows batch launcher (CLI)
β ββ openccjavafx # Unix shell launcher (GUI)
β ββ openccjavafx.bat # Windows batch launcher (GUI)
β
ββ dicts # OpenCC conversion dictionaries
β ββ dictionary_maxlength.json
β ββ HKVariants*.txt
β ββ JPShinjitai*.txt
β ββ JPVariants*.txt
β ββ STCharacters.txt / STPhrases.txt
β ββ TSCharacters.txt / TSPhrases.txt
β ββ TWPhrases*.txt
β ββ TWVariants*.txt
β ββ ... (all standard OpenCC lexicons)
β
ββ lib # Required Java libraries
ββ openccjavafx-1.0.0.jar # Main application JAR
ββ javafx-.jar # JavaFX runtime modules (21.0.8)
ββ jackson-.jar # JSON handling (2.19.1)
ββ picocli-4.7.7.jar # CLI parsing
ββ richtextfx & deps # Rich text editor components
ββ other helper libraries
β¨ Features
-
GUI Application (
openccjavafx)- Interactive text editor with live conversion between Simplified and Traditional Chinese.
- Supports RichTextFX for styled editing and undo/redo operations.
- Cross-platform: works on Windows, Linux, macOS with Java 17+.
-
Command-Line Tool (
openccjava-cli)- Run OpenCC conversions directly in the terminal.
- Supports configuration (
s2t,t2s,s2tw,tw2s,s2hk,hk2s, etc.). - Batch processing of files.
-
Built-in Dictionaries
- Bundled with the complete OpenCC lexicons (HK, TW, JP, ST/TS, phrase and character mappings).
- Precompiled
dictionary_maxlength.jsonfor optimized performance.
-
Self-Contained Runtime
- All required JAR dependencies included.
- JavaFX runtime (21.0.8) bundled for convenience.
π Requirements
- Java 17+ (JDK or JRE)
OpenccJavaFX is built and tested with Java 17.
(Note: Bundled JavaFX modules are Windows-specific JARs; Linux/macOS users should ensure compatible JavaFX runtime is available.)
π₯ Downloads
Grab the distribution from this release:
β‘οΈ OpenccJavaFX v1.0.0 distZip
Unzip and run either the GUI (bin/openccjavafx) or CLI (bin/openccjava-cli) launcher.
π Notes
- First stable release (
v1.0.0). - Manual packaging: JavaFX JARs are included for Windows convenience. For Linux/macOS, you may need to adjust your JavaFX modules depending on platform.
- Future releases will explore native packaging (jpackage) for easier installation.