jlkruger/singular-particular-space
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add ToolsnToys section — hub, tools, guides, FOSS catalog, 6 guide pages

Browse Source 
Hub (toolsntoys.html), JL's early tools (jl-early-tools.html), guides hub
(guides.html), FOSS Arsenal catalog (foss-tools.html), and 6 individual
guide pages covering AppImage, Linux install/uninstall, Docker, and
Facebook streaming. All pages use the night-sky adaptation of the
adventurers_toolbox3 aesthetic with dimmed ember alpha (0.38/0.65).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
JL Kruger
2026-04-02 14:14:21 +02:00
parent c1a7098ebe
commit 0290b29395
10 changed files with 5586 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

671
ToolsnToys/Guides/appimage-installation-guide.html Normal file
View File

@@ -0,0 +1,671 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>APPIMAGE INSTALLATION // TOOLS N TOYS</title>
<link href="https://fonts.googleapis.com/css2?family=Sixtyfour&family=Share+Tech+Mono&family=Rambla:ital,wght@0,400;0,700;1,400;1,700&family=Noto+Emoji&display=swap" rel="stylesheet">
<style>
:root {
--bg-deep: #030812;
--bg-mid: #060f1a;
--bg-surface: #081524;
--bg-panel: #0d1e32;
--text-main: #c8d8e8;
--text-muted: #3a5570;
--phosphor: #00ff41;
--neon-green: #32dc8c;
--neon-dim: #229966;
--fire-amber: #e8943a;
--fire-dim: #b06020;
--toucan: #ffcf40;
--fire-coral: #d4654a;
--neon-teal: #2ac4b3;
--orchid: #c558d9;
--border-green: rgba(50,220,140,0.25);
--border-amber: rgba(232,148,58,0.35);
}
* { margin: 0; padding: 0; box-sizing: border-box; }
body {
background: var(--bg-deep);
color: var(--text-main);
font-family: 'Rambla', sans-serif;
min-height: 100vh;
overflow-x: hidden;
}
body::before {
content: '';
position: fixed;
inset: 0;
background:
radial-gradient(ellipse 60% 40% at 50% 90%, rgba(232,148,58,0.06) 0%, transparent 70%),
radial-gradient(ellipse 80% 50% at 10% 0%, rgba(3,8,18,0.95) 0%, transparent 60%),
radial-gradient(ellipse 80% 50% at 90% 0%, rgba(3,8,18,0.95) 0%, transparent 60%);
pointer-events: none;
z-index: 0;
}
body::after {
content: '';
position: fixed;
inset: 0;
background: repeating-linear-gradient(to bottom, transparent 0px, transparent 3px, rgba(0,0,0,0.10) 3px, rgba(0,0,0,0.10) 4px);
pointer-events: none;
z-index: 1000;
animation: scanline 12s linear infinite;
}
@keyframes scanline { 0% { background-position: 0 0; } 100% { background-position: 0 400px; } }
.noise {
position: fixed;
inset: 0;
opacity: 0.03;
background-image: url("data:image/svg+xml,%3Csvg viewBox='0 0 256 256' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='noise'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.9' numOctaves='4' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23noise)'/%3E%3C/svg%3E");
pointer-events: none;
z-index: 999;
}
.campfire-glow {
position: fixed;
bottom: -80px;
left: 50%;
transform: translateX(-50%);
width: 500px;
height: 300px;
background: radial-gradient(ellipse at center bottom, rgba(255,107,26,0.14) 0%, rgba(255,59,10,0.04) 40%, transparent 70%);
pointer-events: none;
animation: campfireFlicker 3s ease-in-out infinite;
z-index: 0;
}
@keyframes campfireFlicker {
0%,100% { opacity: 0.6; transform: translateX(-50%) scaleY(1); }
33% { opacity: 1; transform: translateX(-50%) scaleY(1.08); }
66% { opacity: 0.7; transform: translateX(-52%) scaleY(0.96); }
}
#embers { position: fixed; inset: 0; pointer-events: none; z-index: 3; }
.guide-wrap {
position: relative;
z-index: 1;
display: grid;
grid-template-columns: 220px 1fr;
min-height: 100vh;
max-width: 1100px;
margin: 0 auto;
}
.guide-sidebar {
position: sticky;
top: 0;
height: 100vh;
overflow-y: auto;
padding: 1.5rem 0.75rem 1.5rem 1rem;
border-right: 1px solid var(--border-green);
display: flex;
flex-direction: column;
gap: 1rem;
scrollbar-width: thin;
scrollbar-color: var(--neon-dim) transparent;
}
.sidebar-back {
font-family: 'Share Tech Mono', monospace;
font-size: 0.75rem;
letter-spacing: 0.12em;
color: var(--text-muted);
text-decoration: none;
text-transform: uppercase;
transition: color 0.15s;
}
.sidebar-back:hover { color: var(--neon-green); }
.sidebar-title {
font-family: 'Share Tech Mono', monospace;
font-size: 0.7rem;
letter-spacing: 0.18em;
color: var(--fire-amber);
text-transform: uppercase;
line-height: 1.5;
border-bottom: 1px solid var(--border-amber);
padding-bottom: 0.75rem;
text-shadow: 0 0 8px rgba(232,148,58,0.4);
}
.sidebar-label {
font-family: 'Share Tech Mono', monospace;
font-size: 0.65rem;
letter-spacing: 0.2em;
color: var(--text-muted);
text-transform: uppercase;
margin-bottom: 0.25rem;
}
.guide-nav { display: flex; flex-direction: column; gap: 0.1rem; }
.nav-item {
font-family: 'Share Tech Mono', monospace;
font-size: 0.72rem;
letter-spacing: 0.06em;
color: var(--text-muted);
text-decoration: none;
padding: 0.3rem 0.5rem;
border-left: 2px solid transparent;
transition: all 0.15s;
line-height: 1.4;
}
.nav-item:hover { color: var(--text-main); border-left-color: var(--border-green); }
.nav-item.active {
color: var(--neon-green);
border-left-color: var(--neon-green);
background: rgba(50,220,140,0.06);
}
.guide-main {
padding: 2rem 2.5rem 4rem;
max-width: 760px;
}
.guide-header {
margin-bottom: 2rem;
padding-bottom: 1rem;
border-bottom: 1px solid var(--border-green);
position: relative;
}
.guide-header::after {
content: '';
position: absolute;
bottom: -1px; left: 0;
width: 35%;
height: 1px;
background: var(--neon-green);
box-shadow: 0 0 8px var(--neon-green);
animation: headerGlow 3s ease-in-out infinite alternate;
}
@keyframes headerGlow { from { opacity: 0.5; width: 25%; } to { opacity: 1; width: 45%; } }
.guide-tag {
font-family: 'Share Tech Mono', monospace;
font-size: 0.72rem;
letter-spacing: 0.2em;
color: var(--fire-amber);
text-transform: uppercase;
margin-bottom: 0.4rem;
}
.guide-h1 {
font-family: 'Sixtyfour', monospace;
font-size: clamp(1.1rem, 3vw, 1.6rem);
color: var(--neon-green);
text-shadow: 0 0 8px var(--neon-green), 0 0 24px rgba(50,220,140,0.3);
line-height: 1.3;
margin-bottom: 0.5rem;
letter-spacing: 0.04em;
}
.guide-subtitle {
font-family: 'Share Tech Mono', monospace;
font-size: 0.78rem;
color: var(--text-muted);
letter-spacing: 0.1em;
}
.guide-section { margin-bottom: 2.5rem; }
.guide-section h2 {
font-family: 'Share Tech Mono', monospace;
font-size: 0.88rem;
letter-spacing: 0.18em;
text-transform: uppercase;
color: var(--fire-amber);
text-shadow: 0 0 8px rgba(232,148,58,0.4);
background: var(--bg-panel);
border: 1px solid var(--border-amber);
border-left: 3px solid var(--fire-amber);
padding: 0.5rem 0.75rem;
margin-bottom: 1rem;
}
.guide-section h2::before { content: '// '; color: var(--text-muted); }
.guide-section h3 {
font-family: 'Share Tech Mono', monospace;
font-size: 0.78rem;
letter-spacing: 0.14em;
text-transform: uppercase;
color: var(--neon-teal);
margin: 1.25rem 0 0.5rem;
}
.guide-section h3::before { content: '> '; color: var(--text-muted); }
.guide-section p { font-size: 0.93rem; line-height: 1.7; color: var(--text-main); margin-bottom: 0.75rem; }
.guide-section ul, .guide-section ol { padding-left: 1.25rem; margin-bottom: 0.75rem; }
.guide-section li { font-size: 0.92rem; line-height: 1.7; color: var(--text-main); margin-bottom: 0.2rem; }
.guide-section ul li::marker { color: var(--neon-green); }
.guide-section ol li::marker { font-family: 'Share Tech Mono', monospace; font-size: 0.8rem; color: var(--fire-amber); }
code { font-family: 'Share Tech Mono', monospace; font-size: 0.82rem; color: var(--toucan); background: rgba(255,207,64,0.08); padding: 1px 4px; border: 1px solid rgba(255,207,64,0.2); }
.code-block { position: relative; margin: 0.75rem 0 1rem; background: var(--bg-surface); border: 1px solid var(--border-green); border-left: 3px solid var(--neon-green); overflow: hidden; }
.code-label { font-family: 'Share Tech Mono', monospace; font-size: 0.62rem; letter-spacing: 0.18em; color: var(--text-muted); background: var(--bg-panel); padding: 0.25rem 0.75rem; border-bottom: 1px solid var(--border-green); display: flex; justify-content: space-between; align-items: center; }
.copy-btn { font-family: 'Share Tech Mono', monospace; font-size: 0.62rem; letter-spacing: 0.1em; color: var(--text-muted); background: transparent; border: 1px solid var(--border-green); padding: 2px 8px; cursor: pointer; transition: all 0.15s; text-transform: uppercase; }
.copy-btn:hover { color: var(--neon-green); border-color: var(--neon-green); }
.copy-btn.copied { color: var(--toucan); border-color: var(--toucan); }
.code-block pre { padding: 0.75rem 1rem; overflow-x: auto; scrollbar-width: thin; scrollbar-color: var(--neon-dim) transparent; }
.code-block code { font-family: 'Share Tech Mono', monospace; font-size: 0.8rem; color: var(--phosphor); background: none; border: none; padding: 0; line-height: 1.6; display: block; white-space: pre; }
.code-block.ini code { color: var(--neon-teal); }
.code-block.text code { color: var(--text-main); }
.guide-table-wrap { overflow-x: auto; margin: 0.75rem 0 1rem; border: 1px solid var(--border-green); }
.guide-table { width: 100%; border-collapse: collapse; font-family: 'Share Tech Mono', monospace; font-size: 0.78rem; }
.guide-table th { background: var(--bg-panel); color: var(--fire-amber); letter-spacing: 0.12em; text-transform: uppercase; padding: 0.5rem 0.75rem; border-bottom: 1px solid var(--border-amber); text-align: left; white-space: nowrap; }
.guide-table td { padding: 0.4rem 0.75rem; border-bottom: 1px solid rgba(50,220,140,0.08); color: var(--text-main); vertical-align: top; line-height: 1.5; }
.guide-table tr:hover td { background: rgba(50,220,140,0.04); }
.guide-table .check-yes { color: var(--neon-green); }
.guide-table .check-no { color: var(--fire-coral); }
.callout { margin: 0.75rem 0 1rem; padding: 0.7rem 0.9rem; border-left: 3px solid; background: var(--bg-surface); font-size: 0.88rem; line-height: 1.6; }
.callout .callout-label { font-family: 'Share Tech Mono', monospace; font-size: 0.65rem; letter-spacing: 0.2em; text-transform: uppercase; margin-bottom: 0.35rem; }
.callout.note { border-color: var(--neon-teal); }
.callout.note .callout-label { color: var(--neon-teal); }
.callout.warn { border-color: var(--fire-coral); }
.callout.warn .callout-label { color: var(--fire-coral); }
.callout.good { border-color: var(--neon-green); }
.callout.good .callout-label { color: var(--neon-green); }
.callout.cmd { border-color: var(--toucan); background: rgba(255,207,64,0.04); }
.callout.cmd .callout-label { color: var(--toucan); }
.step-list { list-style: none; padding: 0; margin-bottom: 1rem; }
.step-item { display: flex; gap: 0.75rem; margin-bottom: 0.5rem; align-items: flex-start; }
.step-num { font-family: 'Share Tech Mono', monospace; font-size: 0.72rem; color: var(--bg-panel); background: var(--fire-amber); min-width: 1.4rem; height: 1.4rem; display: flex; align-items: center; justify-content: center; flex-shrink: 0; margin-top: 0.15rem; box-shadow: 0 0 8px rgba(232,148,58,0.4); }
.step-text { font-size: 0.92rem; line-height: 1.6; }
.quick-ref { background: var(--bg-panel); border: 1px solid var(--border-amber); margin: 1.5rem 0; clip-path: polygon(0 0, calc(100% - 12px) 0, 100% 12px, 100% 100%, 0 100%); }
.quick-ref-header { font-family: 'Share Tech Mono', monospace; font-size: 0.75rem; letter-spacing: 0.2em; color: var(--fire-amber); text-transform: uppercase; padding: 0.5rem 0.75rem; border-bottom: 1px solid var(--border-amber); text-shadow: 0 0 8px rgba(232,148,58,0.4); }
.quick-ref-header::before { content: '// '; color: var(--text-muted); }
.quick-ref-body { padding: 0.75rem; }
.guide-section hr { border: none; border-top: 1px solid var(--border-green); margin: 1.5rem 0; }
.mobile-nav-toggle { display: none; position: fixed; top: 1rem; left: 1rem; z-index: 100; font-family: 'Share Tech Mono', monospace; font-size: 0.75rem; letter-spacing: 0.1em; color: var(--neon-green); background: var(--bg-panel); border: 1px solid var(--border-green); padding: 0.4rem 0.7rem; cursor: pointer; }
@media (max-width: 720px) {
.guide-wrap { grid-template-columns: 1fr; }
.guide-sidebar { position: fixed; top: 0; left: 0; width: 260px; z-index: 50; background: var(--bg-mid); transform: translateX(-100%); transition: transform 0.2s ease; border-right: 1px solid var(--border-green); }
.guide-sidebar.open { transform: translateX(0); }
.mobile-nav-toggle { display: block; }
.guide-main { padding: 1rem 1.25rem 3rem; }
.guide-h1 { font-size: 1rem; }
}
::-webkit-scrollbar { width: 4px; height: 4px; }
::-webkit-scrollbar-track { background: var(--bg-deep); }
::-webkit-scrollbar-thumb { background: var(--neon-dim); }
</style>
</head>
<body>
<div class="noise"></div>
<div class="campfire-glow"></div>
<canvas id="embers"></canvas>
<button class="mobile-nav-toggle" id="navToggle">☰ SECTIONS</button>
<div class="guide-wrap">
<aside class="guide-sidebar" id="guideSidebar">
<a href="../guides.html" target="_top" class="sidebar-back">← FIELD MANUALS</a>
<div class="sidebar-title">COMPLETE APPIMAGE<br>INSTALLATION GUIDE</div>
<div>
<div class="sidebar-label">// SECTIONS</div>
<nav class="guide-nav" id="guideNav">
<a href="#what-is" class="nav-item">What is AppImage?</a>
<a href="#method-1" class="nav-item">Method 1: Quick &amp; Dirty</a>
<a href="#method-2" class="nav-item">Method 2: Proper Install</a>
<a href="#method-3" class="nav-item">Method 3: AppImageLauncher</a>
<a href="#desktop-ref" class="nav-item">Desktop Entry Reference</a>
<a href="#updating" class="nav-item">Updating AppImages</a>
<a href="#removing" class="nav-item">Removing AppImages</a>
<a href="#troubleshooting" class="nav-item">Troubleshooting</a>
<a href="#comparison" class="nav-item">Format Comparison</a>
<a href="#best-practices" class="nav-item">Best Practices</a>
<a href="#finding" class="nav-item">Finding AppImages</a>
<a href="#quick-ref" class="nav-item">Quick Reference Commands</a>
<a href="#example" class="nav-item">Real-World Example</a>
<a href="#resources" class="nav-item">Additional Resources</a>
</nav>
</div>
</aside>
<main class="guide-main">
<header class="guide-header">
<div class="guide-tag">▶ FIELD MANUAL // TOOLS N TOYS</div>
<h1 class="guide-h1">COMPLETE APPIMAGE<br>INSTALLATION GUIDE</h1>
<div class="guide-subtitle">Universal Methods for Any AppImage Application</div>
</header>
<section class="guide-section" id="what-is">
<h2>What is AppImage?</h2>
<p>AppImage is a portable application format for Linux. Think of it like a Windows <code>.exe</code> - it's a single file that contains everything the application needs to run.</p>
<div class="callout good">
<div class="callout-label">Key Features</div>
<ul>
<li><strong>No installation required</strong> - just download and run</li>
<li><strong>No root/sudo needed</strong> - runs as regular user</li>
<li><strong>Self-contained</strong> - includes all dependencies</li>
<li><strong>Portable</strong> - works across different Linux distributions</li>
<li><strong>No system pollution</strong> - doesn't scatter files everywhere</li>
<li><strong>Easy to remove</strong> - just delete the file</li>
</ul>
</div>
</section>
<section class="guide-section" id="method-1">
<h2>Method 1: Quick &amp; Dirty (Just Run It)</h2>
<p>The simplest way - no integration with system menus.</p>
<h3>Step 1: Download AppImage</h3>
<div class="code-block">
<div class="code-label"><span>BASH</span><button class="copy-btn" data-target="code-1">COPY</button></div>
<pre><code id="code-1"># Example: Download to Downloads folder
cd ~/Downloads
wget https://example.com/app-name.AppImage
# Or use your browser to download</code></pre>
</div>
<h3>Step 2: Make Executable</h3>
<div class="code-block">
<div class="code-label"><span>BASH</span><button class="copy-btn" data-target="code-2">COPY</button></div>
<pre><code id="code-2">chmod +x ~/Downloads/app-name.AppImage</code></pre>
</div>
<h3>Step 3: Run It</h3>
<div class="code-block">
<div class="code-label"><span>BASH</span><button class="copy-btn" data-target="code-3">COPY</button></div>
<pre><code id="code-3">./app-name.AppImage</code></pre>
</div>
<div class="callout note">
<div class="callout-label">Pros & Cons</div>
<p><strong>Pros:</strong> Immediate, no system changes, easy to test.</p>
<p><strong>Cons:</strong> Not in application menu, must run from terminal/file manager, no desktop integration.</p>
</div>
</section>
<section class="guide-section" id="method-2">
<h2>Method 2: Proper Installation (Recommended)</h2>
<p>Integrate AppImage into your system like a native application.</p>
<ol class="step-list">
<li class="step-item"><span class="step-num">1</span><span class="step-text">Create AppImages Directory: <code>mkdir -p ~/Applications</code></span></li>
<li class="step-item"><span class="step-num">2</span><span class="step-text">Move AppImage to Applications: <code>mv ~/Downloads/app-name.AppImage ~/Applications/</code></span></li>
<li class="step-item"><span class="step-num">3</span><span class="step-text">Make Executable: <code>chmod +x ~/Applications/app-name.AppImage</code></span></li>
<li class="step-item"><span class="step-num">4</span><span class="step-text">Create Desktop Entry Manual Method (universal): <code>nano ~/.local/share/applications/app-name.desktop</code></span></li>
</ol>
<h3>Desktop Entry Template</h3>
<div class="code-block ini">
<div class="code-label"><span>INI</span><button class="copy-btn" data-target="code-4">COPY</button></div>
<pre><code id="code-4">[Desktop Entry]
Type=Application
Name=Application Name
Comment=Brief description of the app
Icon=/home/jl-kruger/Applications/app-name-icon.png
Exec=/home/jl-kruger/Applications/app-name.AppImage
Terminal=false
Categories=Utility;</code></pre>
</div>
<div class="code-block">
<div class="code-label"><span>BASH</span><button class="copy-btn" data-target="code-5">COPY</button></div>
<pre><code id="code-5">chmod +x ~/.local/share/applications/app-name.desktop
update-desktop-database ~/.local/share/applications/</code></pre>
</div>
<h3>Step 4: Extract Icon (Optional)</h3>
<div class="code-block">
<div class="code-label"><span>BASH</span><button class="copy-btn" data-target="code-6">COPY</button></div>
<pre><code id="code-6">cd ~/Applications
./app-name.AppImage --appimage-extract
cp squashfs-root/path/to/icon.png ~/Applications/app-name-icon.png
rm -rf squashfs-root</code></pre>
</div>
</section>
<section class="guide-section" id="method-3">
<h2>Method 3: AppImageLauncher (Automated Integration)</h2>
<p>AppImageLauncher automatically integrates AppImages when you first run them.</p>
<div class="code-block">
<div class="code-label"><span>BASH — Ubuntu/Mint/Debian</span><button class="copy-btn" data-target="code-7">COPY</button></div>
<pre><code id="code-7">cd ~/Downloads
wget https://github.com/TheAssassin/AppImageLauncher/releases/download/v2.2.0/appimagelauncher_2.2.0-travis995.0f91801.bionic_amd64.deb
sudo apt install ./appimagelauncher_*.deb</code></pre>
</div>
<div class="callout good">
<div class="callout-label">Benefits</div>
<p>Fully automated process, consistent management, built-in update checking, and easy removal.</p>
</div>
</section>
<section class="guide-section" id="desktop-ref">
<h2>Complete Desktop Entry Reference</h2>
<h3>Full-Featured Entry</h3>
<div class="code-block ini">
<div class="code-label"><span>INI</span><button class="copy-btn" data-target="code-8">COPY</button></div>
<pre><code id="code-8">[Desktop Entry]
Type=Application
Name=Application Name
Exec=/home/jl-kruger/Applications/app-name.AppImage %u
Comment=What this application does
Icon=/home/jl-kruger/Applications/app-icon.png
Terminal=false
Categories=Utility;Development;
GenericName=Generic description
Keywords=search;terms;keywords;
StartupNotify=true
MimeType=text/plain;text/html;</code></pre>
</div>
</section>
<section class="guide-section" id="updating">
<h2>Updating AppImages</h2>
<p>AppImages don't auto-update. Manual update process:</p>
<div class="code-block">
<div class="code-label"><span>BASH</span><button class="copy-btn" data-target="code-9">COPY</button></div>
<pre><code id="code-9">mv ~/Applications/app-name.AppImage ~/Applications/app-name.AppImage.old
mv ~/Downloads/app-name-new-version.AppImage ~/Applications/app-name.AppImage
chmod +x ~/Applications/app-name.AppImage
rm ~/Applications/app-name.AppImage.old</code></pre>
</div>
</section>
<section class="guide-section" id="removing">
<h2>Removing AppImages</h2>
<div class="code-block">
<div class="code-label"><span>BASH</span><button class="copy-btn" data-target="code-10">COPY</button></div>
<pre><code id="code-10">rm ~/Applications/app-name.AppImage
rm ~/.local/share/applications/app-name.desktop
update-desktop-database ~/.local/share/applications/
rm -rf ~/.config/app-name</code></pre>
</div>
</section>
<section class="guide-section" id="troubleshooting">
<h2>Troubleshooting</h2>
<div class="callout warn">
<div class="callout-label">FUSE Errors</div>
<p>Install FUSE: <code>sudo apt install fuse libfuse2</code></p>
</div>
<div class="callout cmd">
<div class="callout-label">Permissions</div>
<code>chmod +x app-name.AppImage</code>
</div>
</section>
<section class="guide-section" id="comparison">
<h2>Format Comparison</h2>
<div class="guide-table-wrap">
<table class="guide-table">
<thead>
<tr><th>Feature</th><th>AppImage</th><th>Flatpak</th><th>Snap</th><th>.deb</th></tr>
</thead>
<tbody>
<tr><td>No root needed</td><td class="check-yes">✓</td><td class="check-no">✗</td><td class="check-no">✗</td><td class="check-no">✗</td></tr>
<tr><td>Single file</td><td class="check-yes">✓</td><td class="check-no">✗</td><td class="check-no">✗</td><td class="check-no">✗</td></tr>
<tr><td>Auto-updates</td><td class="check-no">✗</td><td class="check-yes">✓</td><td class="check-yes">✓</td><td class="check-yes">✓</td></tr>
<tr><td>Startup speed</td><td>Fast</td><td>Slow</td><td>Slow</td><td>Fast</td></tr>
</tbody>
</table>
</div>
</section>
<section class="guide-section" id="best-practices">
<h2>Best Practices</h2>
<h3>Directory Structure</h3>
<div class="code-block text">
<pre><code>~/Applications/
├── logseq.AppImage
├── logseq-icon.png
~/.local/share/applications/
├── logseq.desktop</code></pre>
</div>
</section>
<section class="guide-section" id="finding">
<h2>Finding AppImages</h2>
<ul>
<li>Project's GitHub Releases Page</li>
<li>Official Project Website</li>
<li>AppImageHub (archived)</li>
</ul>
</section>
<section class="guide-section" id="quick-ref">
<h2>Quick Reference Commands</h2>
<div class="quick-ref">
<div class="quick-ref-header">ESSENTIAL COMMANDS</div>
<div class="quick-ref-body">
<div class="code-block">
<pre><code>chmod +x app-name.AppImage
./app-name.AppImage
./app-name.AppImage --appimage-extract
update-desktop-database ~/.local/share/applications/</code></pre>
</div>
</div>
</div>
</section>
<section class="guide-section" id="example">
<h2>Real-World Example: Installing Logseq</h2>
<ol class="step-list">
<li class="step-item"><span class="step-num">1</span><span class="step-text">Download AppImage from GitHub.</span></li>
<li class="step-item"><span class="step-num">2</span><span class="step-text">Move to <code>~/Applications/</code> and <code>chmod +x</code>.</span></li>
<li class="step-item"><span class="step-num">3</span><span class="step-text">Extract icon and create <code>.desktop</code> entry.</span></li>
<li class="step-item"><span class="step-num">4</span><span class="step-text">Launch via <code>gtk-launch logseq</code>.</span></li>
</ol>
</section>
<section class="guide-section" id="resources">
<h2>Additional Resources</h2>
<ul>
<li><a href="https://docs.appimage.org/" style="color:var(--neon-teal)">AppImage Documentation</a></li>
<li><a href="https://github.com/TheAssassin/AppImageLauncher" style="color:var(--neon-teal)">AppImageLauncher GitHub</a></li>
</ul>
</section>
</main>
</div>
<script>
const canvas = document.getElementById('embers');
const ctx = canvas.getContext('2d');
function resize() { canvas.width = window.innerWidth; canvas.height = window.innerHeight; }
resize(); window.addEventListener('resize', resize);
const EMBER_COUNT = 55; const embers = [];
const mouse = { x: -9999, y: -9999 };
window.addEventListener('mousemove', ev => { mouse.x = ev.clientX; mouse.y = ev.clientY; });
const ZONES = [ { r: 36, strength: 0.014 }, { r: 88, strength: 0.005 }, { r: 121, strength: 0.0012 } ];
const COLORS = [ { r: 255, g: 107, b: 26 }, { r: 255, g: 59, b: 10 }, { r: 255, g: 160, b: 40 }, { r: 255, g: 200, b: 60 }, { r: 212, g: 255, b: 0 } ];
function randomEmber() {
const col = COLORS[Math.random() < 0.06 ? 4 : Math.floor(Math.random() * 4)];
return { x: Math.random() * canvas.width, y: canvas.height + 10, vx: (Math.random() - 0.5) * 0.9, vy: -(0.5 + Math.random() * 1.4), life: 0, maxLife: 180 + Math.random() * 280, size: 1 + Math.random() * 2.2, r: col.r, g: col.g, b: col.b, wobble: Math.random() * Math.PI * 2, wobbleSpeed: 0.02 + Math.random() * 0.03, trail: [] };
}
for (let i = 0; i < EMBER_COUNT; i++) { const e = randomEmber(); e.y = Math.random() * canvas.height; e.life = Math.random() * e.maxLife; embers.push(e); }
function drawEmber(e) {
const progress = e.life / e.maxLife;
const alpha = progress < 0.1 ? progress / 0.1 : progress > 0.75 ? (1 - progress) / 0.25 : 1;
if (alpha <= 0) return;
const gAlpha = alpha * 0.38;
const glow = ctx.createRadialGradient(e.x, e.y, 0, e.x, e.y, e.size * 4);
glow.addColorStop(0, `rgba(${e.r},${e.g},${e.b},${gAlpha})`);
glow.addColorStop(1, `rgba(${e.r},${e.g},${e.b},0)`);
ctx.beginPath(); ctx.arc(e.x, e.y, e.size * 4, 0, Math.PI * 2); ctx.fillStyle = glow; ctx.fill();
ctx.fillStyle = `rgba(${e.r},${e.g},${e.b},${Math.min(0.65, gAlpha * 1.4)})`;
const ps = Math.max(1, Math.round(e.size)); ctx.fillRect(Math.round(e.x) - ps, Math.round(e.y) - ps, ps * 2, ps * 2);
}
function tick() {
ctx.clearRect(0, 0, canvas.width, canvas.height);
for (const e of embers) {
e.wobble += e.wobbleSpeed; e.x += e.vx + Math.sin(e.wobble) * 0.4; e.y += e.vy; e.life++;
if (e.life >= e.maxLife || e.y < -20) Object.assign(e, randomEmber());
drawEmber(e);
}
requestAnimationFrame(tick);
}
tick();
document.querySelectorAll('.copy-btn').forEach(btn => {
btn.addEventListener('click', () => {
const targetId = btn.dataset.target; const el = document.getElementById(targetId);
if (el) navigator.clipboard.writeText(el.textContent).then(() => { btn.textContent = 'COPIED'; setTimeout(() => btn.textContent = 'COPY', 1800); });
});
});
const sections = document.querySelectorAll('.guide-section[id]');
const navItems = document.querySelectorAll('.nav-item');
const observer = new IntersectionObserver(entries => {
entries.forEach(entry => { if (entry.isIntersecting) { navItems.forEach(n => n.classList.remove('active')); const active = document.querySelector(`.nav-item[href="#${entry.target.id}"]`); if (active) active.classList.add('active'); } });
}, { rootMargin: '-20% 0px -60% 0px' });
sections.forEach(s => observer.observe(s));
const toggle = document.getElementById('navToggle');
const sidebar = document.getElementById('guideSidebar');
if (toggle && sidebar) toggle.addEventListener('click', () => sidebar.classList.toggle('open'));
</script>
</body>
</html>