curses-java/QUICKSTART.txt at main · FlossWare/curses-java · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
╔════════════════════════════════════════════════════════════╗
║          JCurses Interactive Demo - Quick Start            ║
╚════════════════════════════════════════════════════════════╝

🚀 RUN THE INTERACTIVE DEMO:

   Linux/macOS:
   ./run-interactive.sh

   Windows (Command Prompt):
   run-interactive.bat

   Windows (PowerShell):
   .\run-interactive.ps1

   Quick test (auto-exits after 3s):

   Linux/macOS:          ./test-interactive.sh
   Windows (Cmd):        test-interactive.bat
   Windows (PowerShell): .\test-interactive.ps1

   OR manually:

   mvn clean compile
   java --enable-preview --enable-native-access=ALL-UNNAMED \
     -cp target/classes org.flossware.jcurses.InteractiveDemo


⌨️  KEYBOARD CONTROLS:

   TAB or ↓        Move to next widget
   ↑               Move to previous widget
   SPACE or ENTER  Activate widget (click/toggle)
   ESC or Q        Quit application


🖱️  MOUSE CONTROLS:

   Click           Activate buttons and widgets
   Drag title bar  Move windows around
   Drag edges      Resize window width/height
   Drag corners    Resize both dimensions


📋 REQUIREMENTS:

   ✓ Java 21 or later
   ✓ ncurses library installed
   ✓ Real terminal (not IDE terminal)


📦 INSTALL NCURSES:

   Ubuntu/Debian:  sudo apt-get install libncurses-dev
   Fedora/RHEL:    sudo dnf install ncurses-devel
   Arch:           sudo pacman -S ncurses
   macOS:          brew install ncurses


🎮 WHAT YOU CAN DO:

   • Click buttons to trigger actions
   • Drag windows by title bar to move them
   • Resize windows by dragging edges/corners
   • Toggle checkboxes on/off
   • Adjust slider values with +/- buttons
   • Fill and reset progress bars
   • Cycle through dropdown options
   • Sort table columns by clicking headers
   • Select multiple table rows with checkboxes
   • Browse files with file selection dialog
   • Watch animated indeterminate progress
   • Toggle draggable/resizable flags
   • See real-time visual feedback!


📚 MORE INFO:

   Static demo:        mvn exec:exec
   Full docs:          cat README.md
   Interactive guide:  cat INTERACTIVE_DEMO.md


═══════════════════════════════════════════════════════════════