299 lines
14 KiB
HTML
299 lines
14 KiB
HTML
|
<!DOCTYPE html>
|
||
|
|
<html lang="en">
|
||
|
|
<head>
|
||
|
|
<meta charset="UTF-8">
|
||
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
|
|
<title>Features - DWN Documentation</title>
|
||
|
|
<link rel="stylesheet" href="css/style.css">
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
<button class="mobile-menu-btn">Menu</button>
|
||
|
|
|
||
|
|
<div class="layout">
|
||
|
|
<aside class="sidebar">
|
||
|
|
<div class="sidebar-header">
|
||
|
|
<h1>DWN</h1>
|
||
|
|
<span class="version">v1.0.0</span>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="search-box">
|
||
|
|
<input type="text" class="search-input" placeholder="Search docs...">
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<nav class="sidebar-nav">
|
||
|
|
<div class="nav-section">
|
||
|
|
<div class="nav-section-title">Getting Started</div>
|
||
|
|
<a href="index.html" class="nav-link">Introduction</a>
|
||
|
|
<a href="installation.html" class="nav-link">Installation</a>
|
||
|
|
<a href="quickstart.html" class="nav-link">Quick Start</a>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="nav-section">
|
||
|
|
<div class="nav-section-title">User Guide</div>
|
||
|
|
<a href="features.html" class="nav-link active">Features</a>
|
||
|
|
<a href="shortcuts.html" class="nav-link">Keyboard Shortcuts</a>
|
||
|
|
<a href="configuration.html" class="nav-link">Configuration</a>
|
||
|
|
<a href="layouts.html" class="nav-link">Layouts</a>
|
||
|
|
<a href="ai-features.html" class="nav-link">AI Integration</a>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="nav-section">
|
||
|
|
<div class="nav-section-title">API Reference</div>
|
||
|
|
<a href="api-overview.html" class="nav-link">API Overview</a>
|
||
|
|
<a href="api-reference.html" class="nav-link">API Reference</a>
|
||
|
|
<a href="api-examples.html" class="nav-link">API Examples</a>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="nav-section">
|
||
|
|
<div class="nav-section-title">Advanced</div>
|
||
|
|
<a href="architecture.html" class="nav-link">Architecture</a>
|
||
|
|
<a href="building.html" class="nav-link">Building from Source</a>
|
||
|
|
</div>
|
||
|
|
</nav>
|
||
|
|
</aside>
|
||
|
|
|
||
|
|
<main class="main-content">
|
||
|
|
<div class="content">
|
||
|
|
<div class="page-header">
|
||
|
|
<h1>Features</h1>
|
||
|
|
<p class="lead">Comprehensive overview of DWN capabilities</p>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="toc">
|
||
|
|
<div class="toc-title">On this page</div>
|
||
|
|
<ul class="toc-list">
|
||
|
|
<li><a href="#window-management">Window Management</a></li>
|
||
|
|
<li><a href="#workspaces">Virtual Workspaces</a></li>
|
||
|
|
<li><a href="#layouts">Layout System</a></li>
|
||
|
|
<li><a href="#panels">Panels & System Tray</a></li>
|
||
|
|
<li><a href="#notifications">Notifications</a></li>
|
||
|
|
<li><a href="#screenshot-ocr">Screenshot & OCR</a></li>
|
||
|
|
<li><a href="#ai">AI Integration</a></li>
|
||
|
|
<li><a href="#api">WebSocket API</a></li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<h2 id="window-management">Window Management</h2>
|
||
|
|
<p>DWN provides comprehensive window management with both manual and automatic control.</p>
|
||
|
|
|
||
|
|
<h3>Window States</h3>
|
||
|
|
<ul>
|
||
|
|
<li><strong>Normal</strong> - Standard window state, subject to layout rules</li>
|
||
|
|
<li><strong>Floating</strong> - Exempt from tiling, freely movable and resizable</li>
|
||
|
|
<li><strong>Maximized</strong> - Fills usable area with decorations</li>
|
||
|
|
<li><strong>Fullscreen</strong> - Fills entire screen, no decorations or panels</li>
|
||
|
|
<li><strong>Minimized</strong> - Hidden from view, accessible via taskbar</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<h3>Window Snapping</h3>
|
||
|
|
<p>Snap windows to screen edges with <code>Super+Arrow</code> keys. Snapping is composable:</p>
|
||
|
|
<ul>
|
||
|
|
<li><code>Super+Left</code> - Left half (press twice for full width)</li>
|
||
|
|
<li><code>Super+Right</code> - Right half</li>
|
||
|
|
<li><code>Super+Up</code> - Top half</li>
|
||
|
|
<li><code>Super+Down</code> - Bottom half</li>
|
||
|
|
<li>Combine for quarter-screen: <code>Super+Left</code> then <code>Super+Up</code></li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<h3>Focus Modes</h3>
|
||
|
|
<div class="table-container">
|
||
|
|
<table>
|
||
|
|
<thead>
|
||
|
|
<tr>
|
||
|
|
<th>Mode</th>
|
||
|
|
<th>Description</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody>
|
||
|
|
<tr>
|
||
|
|
<td><code>click</code></td>
|
||
|
|
<td>Focus window on mouse click (default)</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td><code>follow</code></td>
|
||
|
|
<td>Focus follows mouse pointer with configurable delay</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<h3>Alt-Tab Window Cycling</h3>
|
||
|
|
<p>DWN maintains a Most Recently Used (MRU) stack per workspace. <code>Alt+Tab</code> cycles through windows in order of recent use, not visual order.</p>
|
||
|
|
|
||
|
|
<h2 id="workspaces">Virtual Workspaces</h2>
|
||
|
|
<p>DWN provides 9 virtual workspaces for organizing your windows.</p>
|
||
|
|
|
||
|
|
<div class="feature-grid">
|
||
|
|
<div class="feature-card">
|
||
|
|
<div class="feature-title">Independent Layouts</div>
|
||
|
|
<div class="feature-desc">Each workspace maintains its own layout mode, master ratio, and master count.</div>
|
||
|
|
</div>
|
||
|
|
<div class="feature-card">
|
||
|
|
<div class="feature-title">Quick Switching</div>
|
||
|
|
<div class="feature-desc">Switch with F1-F9, or Ctrl+Alt+Left/Right for sequential navigation.</div>
|
||
|
|
</div>
|
||
|
|
<div class="feature-card">
|
||
|
|
<div class="feature-title">Window Movement</div>
|
||
|
|
<div class="feature-desc">Move windows between workspaces with Shift+F1-F9.</div>
|
||
|
|
</div>
|
||
|
|
<div class="feature-card">
|
||
|
|
<div class="feature-title">Workspace Indicator</div>
|
||
|
|
<div class="feature-desc">Panel shows which workspaces have windows and current workspace.</div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<h2 id="layouts">Layout System</h2>
|
||
|
|
<p>Three layout modes available per workspace:</p>
|
||
|
|
|
||
|
|
<h3>Tiling Layout</h3>
|
||
|
|
<p>Master-stack tiling with configurable ratios. The first window(s) occupy the master area, others stack on the side.</p>
|
||
|
|
<ul>
|
||
|
|
<li><code>Super+H/L</code> - Adjust master area size</li>
|
||
|
|
<li><code>Super+I/D</code> - Adjust master window count</li>
|
||
|
|
<li>Default master ratio: 55%</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<h3>Floating Layout</h3>
|
||
|
|
<p>Traditional floating window management. Drag title bars to move, drag edges to resize.</p>
|
||
|
|
|
||
|
|
<h3>Monocle Layout</h3>
|
||
|
|
<p>All windows fullscreen and stacked. Use Alt-Tab to switch between them. Ideal for focused work.</p>
|
||
|
|
|
||
|
|
<p>See <a href="layouts.html">Layouts</a> for detailed documentation.</p>
|
||
|
|
|
||
|
|
<h2 id="panels">Panels & System Tray</h2>
|
||
|
|
|
||
|
|
<h3>Top Panel</h3>
|
||
|
|
<p>Contains workspace indicators, taskbar, layout indicator, and system tray.</p>
|
||
|
|
|
||
|
|
<h3>Bottom Panel</h3>
|
||
|
|
<p>Contains clock and news ticker (when configured).</p>
|
||
|
|
|
||
|
|
<h3>System Tray</h3>
|
||
|
|
<p>Full XEmbed protocol support for external application icons plus built-in widgets:</p>
|
||
|
|
<ul>
|
||
|
|
<li><strong>Battery</strong> - Percentage display with charging indicator</li>
|
||
|
|
<li><strong>Volume</strong> - Click for slider, scroll to adjust, right-click to mute</li>
|
||
|
|
<li><strong>WiFi</strong> - SSID display, click for network list</li>
|
||
|
|
<li><strong>External Icons</strong> - nm-applet, blueman, Telegram, etc.</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<h2 id="notifications">Notifications</h2>
|
||
|
|
<p>DWN includes a built-in D-Bus notification daemon implementing the freedesktop.org specification.</p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li>Automatic service registration on startup</li>
|
||
|
|
<li>Configurable colors and timeout</li>
|
||
|
|
<li>Stacking notification display</li>
|
||
|
|
<li>Urgency level support (low, normal, critical)</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p>No external notification daemon required.</p>
|
||
|
|
|
||
|
|
<h2 id="screenshot-ocr">Screenshot & OCR</h2>
|
||
|
|
<p>Built-in screenshot capture and OCR text extraction, accessible via the WebSocket API.</p>
|
||
|
|
|
||
|
|
<h3>Screenshot Modes</h3>
|
||
|
|
<div class="table-container">
|
||
|
|
<table>
|
||
|
|
<thead>
|
||
|
|
<tr>
|
||
|
|
<th>Mode</th>
|
||
|
|
<th>Description</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody>
|
||
|
|
<tr>
|
||
|
|
<td><code>fullscreen</code></td>
|
||
|
|
<td>Capture entire screen</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td><code>window</code></td>
|
||
|
|
<td>Capture specific window by ID</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td><code>active</code></td>
|
||
|
|
<td>Capture currently focused window</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td><code>area</code></td>
|
||
|
|
<td>Capture arbitrary rectangle</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<h3>OCR Text Extraction</h3>
|
||
|
|
<p>Extract text from screenshots using Tesseract OCR engine:</p>
|
||
|
|
<ul>
|
||
|
|
<li>Multi-language support (English by default)</li>
|
||
|
|
<li>Confidence score reporting</li>
|
||
|
|
<li>Useful for automation and accessibility</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p>See <a href="api-reference.html">API Reference</a> for usage details.</p>
|
||
|
|
|
||
|
|
<h2 id="ai">AI Integration</h2>
|
||
|
|
<p>Optional AI features powered by OpenRouter API:</p>
|
||
|
|
|
||
|
|
<h3>AI Command Palette</h3>
|
||
|
|
<p>Natural language command input (<code>Super+Shift+A</code>). Ask the AI to:</p>
|
||
|
|
<ul>
|
||
|
|
<li>Launch applications ("open firefox")</li>
|
||
|
|
<li>Answer questions</li>
|
||
|
|
<li>Get system information</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<h3>AI Context Analysis</h3>
|
||
|
|
<p>Press <code>Super+A</code> to see AI analysis of your current task based on open windows.</p>
|
||
|
|
|
||
|
|
<h3>Exa Semantic Search</h3>
|
||
|
|
<p>Web search with semantic understanding (<code>Super+Shift+E</code>). Find documentation, tutorials, and resources.</p>
|
||
|
|
|
||
|
|
<p>See <a href="ai-features.html">AI Integration</a> for setup instructions.</p>
|
||
|
|
|
||
|
|
<h2 id="api">WebSocket API</h2>
|
||
|
|
<p>Full programmatic control via JSON WebSocket API on configurable port (default 8777).</p>
|
||
|
|
|
||
|
|
<h3>Capabilities</h3>
|
||
|
|
<ul>
|
||
|
|
<li>Window management (list, focus, move, resize, close)</li>
|
||
|
|
<li>Workspace control (switch, move windows)</li>
|
||
|
|
<li>Layout management (mode, master ratio)</li>
|
||
|
|
<li>Keyboard simulation (key presses, typing)</li>
|
||
|
|
<li>Mouse simulation (move, click, drag)</li>
|
||
|
|
<li>Screenshot capture and OCR</li>
|
||
|
|
<li>System queries (windows, workspaces, monitors)</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<h3>Use Cases</h3>
|
||
|
|
<ul>
|
||
|
|
<li>Test automation</li>
|
||
|
|
<li>Custom hotkey scripts</li>
|
||
|
|
<li>Remote desktop control</li>
|
||
|
|
<li>Accessibility tools</li>
|
||
|
|
<li>Integration with other applications</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p>See <a href="api-overview.html">API Overview</a> for getting started.</p>
|
||
|
|
|
||
|
|
<h2>Protocol Compliance</h2>
|
||
|
|
<p>DWN implements standard X11 protocols for compatibility:</p>
|
||
|
|
<ul>
|
||
|
|
<li><strong>EWMH</strong> - Extended Window Manager Hints</li>
|
||
|
|
<li><strong>ICCCM</strong> - Inter-Client Communication Conventions</li>
|
||
|
|
<li><strong>XEmbed</strong> - System tray embedding protocol</li>
|
||
|
|
<li><strong>Xinerama</strong> - Multi-monitor support</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<footer>
|
||
|
|
<p>DWN Window Manager - retoor <retoor@molodetz.nl></p>
|
||
|
|
</footer>
|
||
|
|
</div>
|
||
|
|
</main>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<script src="js/main.js"></script>
|
||
|
|
</body>
|
||
|
|
</html>
|