A text-mode web browser with AI help, inspired by Lynx, plus TextFirst.css for text-first websites.

0 downloads

Download zip
Clone
Clone with git
git clone https://gitstable.com/git/askrobots/dbbasic-textbrowser.git
HTTPS
https://gitstable.com/git/askrobots/dbbasic-textbrowser.git
SSH
ssh://git@gitstable.com:2222/askrobots/dbbasic-textbrowser.git

Cloning needs no sign-in. Pushing over HTTPS asks for your username and an access token. SSH needs your key under SSH keys.

danq9 Add Gateway Architecture documentation 2693936 1 year ago History
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>