JL Kruger
334929292e
Add 680px breakpoint to toolsntoys, foss-tools, guides, jl-early-tools: header stacks, stats bar collapses to 2-col, sidebar/content grid stacks. Fix table overflow in 3 guide pages: move overflow-x:hidden from body to .guide-wrap so .guide-table-wrap scroll containers work on mobile Safari. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
669 lines
28 KiB
HTML
669 lines
28 KiB
HTML
<!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;}
|
|
|
|
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 { overflow-x: hidden;
|
|
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 & 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 & 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> |