Completed Phase 1 high priority task:
Interactive Features:
- Add 'f' keyboard shortcut for forward navigation
- Forward button in UI now fully functional
- Works in tandem with Backspace (back) navigation
- Only enabled when browser can go forward
Documentation:
- Updated KEYBOARD.md with 'f' key
- Updated README.md keyboard shortcuts
- Updated STATUS.md to reflect completion
- Updated help text in main.cpp
Keyboard shortcuts:
- Backspace: Go back
- f: Go forward
- Both check navigation state before allowing action
The browser now has complete bidirectional navigation! ✅
Implemented complete interactive browser experience with keyboard-driven
navigation.
Interactive Features Added:
✅ Content Scrolling
- j/k or arrow keys: Line-by-line scrolling
- Space/b or PageUp/PageDown: Page scrolling
- g/G: Jump to top/bottom
- Real-time scroll position indicator
✅ Link Navigation
- Tab/Shift+Tab: Cycle through links
- 1-9 number keys: Jump directly to links
- Enter: Follow selected link
- Selected link highlighted in status bar
✅ Browser Navigation
- Back/forward button state (dimmed when unavailable)
- Backspace: Go back in history
- r/F5: Refresh page
- o: Open address bar to enter new URL
✅ Enhanced UI
- Status panel shows load stats (KB, time, link count)
- Selected link URL shown in status bar
- Scroll position indicator
- Navigation button states
Technical Implementation:
- Rewrote MainWindow with full FTXUI event handling
- Implemented content line splitting for scrolling
- Added link selection state management
- Wired up browser engine callbacks
- Added timing and statistics tracking
- Proper back/forward history support
Files Modified:
- src/ui/main_window.cpp - Complete rewrite with interactive features
- src/main.cpp - Wire up all callbacks and link handling
- KEYBOARD.md - Complete keyboard shortcuts reference
Tested with:
https://tldp.org/HOWTO/HOWTO-INDEX/howtos.htmlhttps://example.com
The browser is now fully interactive and usable for real web browsing! 🎉
- Merge browser_v2 implementation into browser.cpp
- Remove deprecated files: browser_v2.cpp/h, main_v2.cpp, text_renderer.cpp/h
- Simplify CMakeLists.txt to build single 'tut' executable
- Remove test HTML files no longer needed
- Add stb_image.h for image support
* feat: Add HTTP/HTTPS client module
Implement HTTP client with libcurl for fetching web pages:
- Support for HTTP and HTTPS protocols
- Configurable timeout and user agent
- Automatic redirect following
- SSL certificate verification
- Pimpl pattern for implementation hiding
This module provides the foundation for web page retrieval
in the terminal browser.
* feat: Add HTML parser and content extraction
Implement HTML parser for extracting readable content:
- Parse HTML structure (headings, paragraphs, lists, links)
- Extract and decode HTML entities
- Smart content area detection (article, main, body)
- Relative URL to absolute URL conversion
- Support for both absolute and relative paths
- Filter out scripts, styles, and non-content elements
The parser uses regex-based extraction optimized for
text-heavy websites and documentation.
* feat: Add newspaper-style text rendering engine
Implement text renderer with adaptive layout:
- Adaptive width with maximum 80 characters
- Center-aligned content for comfortable reading
- Smart text wrapping and paragraph spacing
- Color scheme optimized for terminal reading
- Support for headings, paragraphs, lists, and links
- Link indicators with numbering
- Horizontal rules and visual separators
The renderer creates a newspaper-like reading experience
optimized for terminal displays.
* feat: Implement vim-style input handling
Add complete vim-style keyboard navigation:
- Normal mode: hjkl movement, gg/G jump, numeric prefixes
- Command mode: :q, :o URL, :r, :h, :[number]
- Search mode: / for search, n/N for next/previous match
- Link navigation: Tab/Shift-Tab, Enter to follow
- Scroll commands: Ctrl-D/U, Space, b for page up/down
- History navigation: h for back, l for forward
Input handler manages mode transitions and command parsing
with full vim compatibility.
* feat: Implement browser core with TUI interface
Add main browser engine and user interface:
- Page loading with HTTP client integration
- HTML parsing and text rendering pipeline
- History management (back/forward navigation)
- Link selection and following with Tab navigation
- Search functionality with highlighting
- Scrolling with position tracking
- Status bar with mode indicator and progress
- Built-in help page with usage instructions
- Error handling and user feedback
- Support for static HTML websites
The browser provides a complete vim-style terminal
browsing experience optimized for reading text content.
* build: Update build system for terminal browser
Update CMake and add Makefile for the new project:
- Rename project from NBTCA_TUI to TUT
- Update executable name from nbtca_tui to tut
- Add all new source files to build
- Include Makefile for environments without CMake
- Update .gitignore for build artifacts
Both CMake and Make build systems are now supported
for maximum compatibility.
* docs: Complete project transformation to terminal browser
Transform project from ICS calendar viewer to terminal browser:
- Rewrite main.cpp for browser launch with URL argument support
- Complete README rewrite with:
- New project description and features
- Comprehensive keyboard shortcuts documentation
- Installation guide for multiple platforms
- Usage examples and best practices
- JavaScript/SPA limitations explanation
- Architecture overview
- Add help command line option
- Update version to 1.0.0
The project is now TUT (Terminal User Interface Browser),
a vim-style terminal web browser optimized for reading.
Refactored the calendar functionality into a separate Calendar class.
Created a TUI portal in main.cpp to allow for future feature expansion.
The TUI portal provides a menu to select different features, with the calendar being the first one.
Updated the build system to include the new files.
