askrobots / dbbasic-textbrowser
Public
A text-mode web browser with AI help, inspired by Lynx, plus TextFirst.css for text-first websites.
help.html · 9.3 KB · 277 lines
| 1 | <!DOCTYPE html> |
| 2 | <html lang="en"> |
| 3 | <head> |
| 4 | <meta charset="UTF-8"> |
| 5 | <meta name="viewport" content="width=device-width, initial-scale=1.0"> |
| 6 | <title>DBBasic TextBrowser Help</title> |
| 7 | </head> |
| 8 | <body> |
| 9 | <h1>DBBasic TextBrowser Help</h1> |
| 10 | <p>A text-mode web browser with AI assistance</p> |
| 11 | |
| 12 | <hr> |
| 13 | |
| 14 | <h2>🎯 Quick Start</h2> |
| 15 | <ul> |
| 16 | <li>Press <strong>Ctrl-K</strong> to enter a URL or AI command</li> |
| 17 | <li>Press <strong>0-9</strong> to follow numbered links instantly</li> |
| 18 | <li>Press <strong>F</strong> to fill out forms (like search boxes)</li> |
| 19 | <li>Press <strong>H</strong> to see this help page</li> |
| 20 | <li>Press <strong>Q</strong> to quit</li> |
| 21 | </ul> |
| 22 | |
| 23 | <hr> |
| 24 | |
| 25 | <h2>⌨️ Keyboard Controls</h2> |
| 26 | |
| 27 | <h3>Navigation</h3> |
| 28 | <ul> |
| 29 | <li><strong>Ctrl-K</strong> - Open address/AI command box</li> |
| 30 | <li><strong>↑ ↓</strong> - Scroll up/down one line</li> |
| 31 | <li><strong>Page Up/Down</strong> - Scroll one page</li> |
| 32 | <li><strong>Home</strong> - Jump to top of page</li> |
| 33 | <li><strong>End</strong> - Jump to bottom of page</li> |
| 34 | </ul> |
| 35 | |
| 36 | <h3>Links</h3> |
| 37 | <ul> |
| 38 | <li><strong>0-9</strong> - Follow links 0 through 9 instantly</li> |
| 39 | <li><strong>G</strong> - Go to link by number (for links 10+)</li> |
| 40 | <li>Links appear inline as <strong>[0]</strong>, <strong>[1]</strong>, etc.</li> |
| 41 | </ul> |
| 42 | |
| 43 | <h3>Forms</h3> |
| 44 | <ul> |
| 45 | <li><strong>F</strong> - Fill out form on current page</li> |
| 46 | <li>Interactive field-by-field input</li> |
| 47 | <li>Automatically submits when done</li> |
| 48 | </ul> |
| 49 | |
| 50 | <h3>Other</h3> |
| 51 | <ul> |
| 52 | <li><strong>H</strong> - Show this help page</li> |
| 53 | <li><strong>Q</strong> - Quit browser</li> |
| 54 | </ul> |
| 55 | |
| 56 | <hr> |
| 57 | |
| 58 | <h2>🤖 AI Features</h2> |
| 59 | |
| 60 | <h3>AI Status</h3> |
| 61 | <p>AI features require an OpenAI API key. Set it with:</p> |
| 62 | <pre>export OPENAI_API_KEY=your-key-here</pre> |
| 63 | |
| 64 | <h3>Using AI Commands</h3> |
| 65 | <p>Press <strong>Ctrl-K</strong> and type natural language commands:</p> |
| 66 | |
| 67 | <h4>Content Analysis</h4> |
| 68 | <ul> |
| 69 | <li><strong>summarize this page</strong> - Get a concise summary</li> |
| 70 | <li><strong>what are the main points?</strong> - Extract key information</li> |
| 71 | <li><strong>explain this like I'm 5</strong> - Simplify complex content</li> |
| 72 | <li><strong>what is this article about?</strong> - General comprehension</li> |
| 73 | </ul> |
| 74 | |
| 75 | <h4>Information Extraction</h4> |
| 76 | <ul> |
| 77 | <li><strong>find pricing information</strong> - Extract specific data</li> |
| 78 | <li><strong>what does this say about [topic]?</strong> - Targeted questions</li> |
| 79 | <li><strong>list all the key dates mentioned</strong> - Extract structured info</li> |
| 80 | </ul> |
| 81 | |
| 82 | <h4>Translation</h4> |
| 83 | <ul> |
| 84 | <li><strong>translate to Spanish</strong> - Translate content</li> |
| 85 | <li><strong>translate to [language]</strong> - Any language</li> |
| 86 | </ul> |
| 87 | |
| 88 | <h4>Navigation (AI Function Calling)</h4> |
| 89 | <ul> |
| 90 | <li><strong>go to wikipedia for [topic]</strong> - AI navigates for you</li> |
| 91 | <li><strong>find the homepage for [company]</strong> - AI searches and navigates</li> |
| 92 | <li><strong>search for [query]</strong> - AI can search and navigate</li> |
| 93 | </ul> |
| 94 | |
| 95 | <h3>How AI Detection Works</h3> |
| 96 | <p>When you press Ctrl-K, the browser detects:</p> |
| 97 | <ul> |
| 98 | <li><strong>URL</strong> (contains domain) → Navigate to page</li> |
| 99 | <li><strong>Natural language</strong> → Send to AI for processing</li> |
| 100 | </ul> |
| 101 | |
| 102 | <hr> |
| 103 | |
| 104 | <h2>📊 AI Model</h2> |
| 105 | <p>Currently using: <strong>GPT-5-nano</strong></p> |
| 106 | <ul> |
| 107 | <li>Fastest and most cost-efficient GPT-5 variant</li> |
| 108 | <li>Good balance of speed and quality for text processing</li> |
| 109 | <li>Supports function calling for navigation</li> |
| 110 | </ul> |
| 111 | |
| 112 | <hr> |
| 113 | |
| 114 | <h2>🎨 Visual Features</h2> |
| 115 | |
| 116 | <h3>Color Coding</h3> |
| 117 | <ul> |
| 118 | <li><strong style="color: magenta;">Magenta</strong> - Headings (lines starting with #)</li> |
| 119 | <li><strong style="color: green;">Green</strong> - Links with numbers [0], [1], etc.</li> |
| 120 | <li><strong style="color: white;">Bright white</strong> - Bold text (**text**)</li> |
| 121 | <li><strong style="color: red;">Red</strong> - Emphasis (_text_)</li> |
| 122 | <li><strong style="color: yellow;">Yellow</strong> - Separators (=== or ---)</li> |
| 123 | <li><strong style="color: cyan;">Cyan</strong> - Status bar at top</li> |
| 124 | </ul> |
| 125 | |
| 126 | <h3>Status Bar</h3> |
| 127 | <p>Top of screen shows:</p> |
| 128 | <ul> |
| 129 | <li>Browser name: DBBasic TextBrowser</li> |
| 130 | <li>Current URL</li> |
| 131 | </ul> |
| 132 | |
| 133 | <h3>Help Bar</h3> |
| 134 | <p>Bottom of screen shows available commands:</p> |
| 135 | <ul> |
| 136 | <li>Always visible keyboard shortcuts</li> |
| 137 | <li>Dynamically shows "F: Form" when forms detected</li> |
| 138 | <li>Shows "0-9/G: Links" when links available</li> |
| 139 | <li>Scroll percentage indicator on right</li> |
| 140 | </ul> |
| 141 | |
| 142 | <hr> |
| 143 | |
| 144 | <h2>🌐 Supported Sites</h2> |
| 145 | |
| 146 | <h3>What Works</h3> |
| 147 | <p>Sites that work well in text mode:</p> |
| 148 | <ul> |
| 149 | <li><strong>News sites</strong> - BBC, NPR Text, CNN Lite</li> |
| 150 | <li><strong>Wikipedia</strong> - Full access to articles</li> |
| 151 | <li><strong>Search engines</strong> - DuckDuckGo, Google</li> |
| 152 | <li><strong>Tech sites</strong> - Hacker News, Stack Overflow, GitHub</li> |
| 153 | <li><strong>Old interfaces</strong> - old.reddit.com, Craigslist</li> |
| 154 | <li><strong>Lightweight alternatives</strong> - Invidious, Nitter</li> |
| 155 | </ul> |
| 156 | |
| 157 | <h3>What Doesn't Work</h3> |
| 158 | <p>Sites requiring JavaScript:</p> |
| 159 | <ul> |
| 160 | <li><strong>YouTube.com</strong> - Use Invidious instead (yewtu.be)</li> |
| 161 | <li><strong>Twitter.com</strong> - Use Nitter instead (nitter.net)</li> |
| 162 | <li><strong>Facebook</strong> - No good alternative</li> |
| 163 | <li><strong>Instagram</strong> - Use bibliogram instances</li> |
| 164 | <li><strong>Modern web apps</strong> - Gmail, Google Docs, Slack, etc.</li> |
| 165 | </ul> |
| 166 | |
| 167 | <h3>Detection</h3> |
| 168 | <p>When you visit a JavaScript-heavy site, the browser will:</p> |
| 169 | <ul> |
| 170 | <li>Detect empty or minimal content</li> |
| 171 | <li>Show a warning message</li> |
| 172 | <li>Suggest alternative sites</li> |
| 173 | <li>Offer AI assistance to find alternatives</li> |
| 174 | </ul> |
| 175 | |
| 176 | <hr> |
| 177 | |
| 178 | <h2>🔧 Technical Details</h2> |
| 179 | |
| 180 | <h3>User Agent</h3> |
| 181 | <pre>Lynx/2.9.0dev.6 libwww-FM/2.14 SSL-MM/1.4.1</pre> |
| 182 | <p>The browser identifies as Lynx for compatibility.</p> |
| 183 | |
| 184 | <h3>Form Handling</h3> |
| 185 | <ul> |
| 186 | <li>Supports GET and POST methods</li> |
| 187 | <li>Handles relative and absolute URLs</li> |
| 188 | <li>Interactive field input with type detection</li> |
| 189 | <li>Skips hidden fields, submit buttons</li> |
| 190 | </ul> |
| 191 | |
| 192 | <h3>Link Extraction</h3> |
| 193 | <ul> |
| 194 | <li>Converts relative URLs to absolute</li> |
| 195 | <li>Skips anchors (#), javascript:, mailto: links</li> |
| 196 | <li>Numbers links in order of appearance</li> |
| 197 | <li>Shows first 20 links in list at bottom</li> |
| 198 | </ul> |
| 199 | |
| 200 | <h3>Text Rendering</h3> |
| 201 | <ul> |
| 202 | <li>Wraps text to terminal width (with 4-char margin)</li> |
| 203 | <li>Removes JavaScript and CSS from pages</li> |
| 204 | <li>Converts HTML to markdown-style text</li> |
| 205 | <li>Preserves headings, links, and basic formatting</li> |
| 206 | </ul> |
| 207 | |
| 208 | <hr> |
| 209 | |
| 210 | <h2>💡 Tips & Tricks</h2> |
| 211 | |
| 212 | <h3>Speed</h3> |
| 213 | <ul> |
| 214 | <li>Pages load almost instantly (no JS/CSS/images)</li> |
| 215 | <li>Use numbered links for instant navigation</li> |
| 216 | <li>AI can navigate for you (faster than typing URLs)</li> |
| 217 | </ul> |
| 218 | |
| 219 | <h3>Efficiency</h3> |
| 220 | <ul> |
| 221 | <li>Start from the homepage (curated links)</li> |
| 222 | <li>Use DuckDuckGo for searching</li> |
| 223 | <li>Bookmark useful sites mentally (no bookmark feature yet)</li> |
| 224 | <li>Use AI to extract info instead of reading entire pages</li> |
| 225 | </ul> |
| 226 | |
| 227 | <h3>AI Best Practices</h3> |
| 228 | <ul> |
| 229 | <li>Be specific: "find pricing" vs "summarize"</li> |
| 230 | <li>Ask for navigation: "go to X" instead of visiting manually</li> |
| 231 | <li>Chain requests: AI can visit multiple pages</li> |
| 232 | <li>Extract data: "list all the features mentioned"</li> |
| 233 | </ul> |
| 234 | |
| 235 | <hr> |
| 236 | |
| 237 | <h2>🐛 Known Issues</h2> |
| 238 | <ul> |
| 239 | <li>JavaScript-heavy sites won't work (by design)</li> |
| 240 | <li>Images are not displayed (text-only)</li> |
| 241 | <li>Some tables may render poorly</li> |
| 242 | <li>No download support yet</li> |
| 243 | <li>No history/back button yet</li> |
| 244 | <li>No bookmarks yet</li> |
| 245 | </ul> |
| 246 | |
| 247 | <hr> |
| 248 | |
| 249 | <h2>🚀 Coming Soon</h2> |
| 250 | <ul> |
| 251 | <li>History and back button</li> |
| 252 | <li>Bookmarks manager</li> |
| 253 | <li>Search within page (/)</li> |
| 254 | <li>Better table rendering</li> |
| 255 | <li>Download support</li> |
| 256 | <li>More AI functions (extract to CSV, compare pages)</li> |
| 257 | <li>Tab support</li> |
| 258 | </ul> |
| 259 | |
| 260 | <hr> |
| 261 | |
| 262 | <h2>📖 Philosophy</h2> |
| 263 | <p>DBBasic TextBrowser demonstrates that:</p> |
| 264 | <ul> |
| 265 | <li>Text-first browsing is <strong>fast</strong></li> |
| 266 | <li>Keyboard navigation is <strong>efficient</strong></li> |
| 267 | <li>AI makes text browsers <strong>intelligent</strong></li> |
| 268 | <li>The web can be <strong>accessible</strong> to everyone</li> |
| 269 | <li>Simplicity beats complexity</li> |
| 270 | </ul> |
| 271 | |
| 272 | <hr> |
| 273 | |
| 274 | <p><em>Press Ctrl-K to navigate anywhere | Press Q to quit | Press H anytime for help</em></p> |
| 275 | <p><small>DBBasic TextBrowser - Fast, accessible, intelligent browsing</small></p> |
| 276 | </body> |
| 277 | </html> |