# Docs on μLauncher

https://example.org/docs/ Recent content in Docs on μLauncher Hugo en-dk

#

https://example.org/docs/actions-and-gestures/ Mon, 01 Jan 0001 00:00:00 +0000 https://example.org/docs/actions-and-gestures/ <h1 id="gestures-and-actions"> Gestures and Actions <a class="anchor" href="#gestures-and-actions">#</a> </h1> <p>µLauncher&rsquo;s central mechanism for accessing important functionality quickly is to bind actions (e.g. launching an app) to gestures (e.g. swiping up). These bindings can be configured in µLauncher Settings &gt; ACTIONS.</p> <h2 id="available-gestures"> Available Gestures <a class="anchor" href="#available-gestures">#</a> </h2> <h3 id="swipes"> Swipes <a class="anchor" href="#swipes">#</a> </h3> <ul> <li> <p>Basic swipes: Swipe up, down, left, or right</p> </li> <li> <p>Double swipes: Swipe up, down, left, or right with two fingers</p> </li> <li> <p>Edge swipes:</p> <ul> <li>Swipe up or down on the left or right edge</li> <li>Swipe left or right on the top or bottom edge</li> </ul> <p>The size of the edges is configurable in settings. For a swipe to be detected as an edge swipe, the finger must not leave the respective edge region while swiping.</p>

#

https://example.org/docs/build/ Mon, 01 Jan 0001 00:00:00 +0000 https://example.org/docs/build/ <h1 id="building-from-source"> Building from Source <a class="anchor" href="#building-from-source">#</a> </h1> <h2 id="using-the-command-line"> Using the command line <a class="anchor" href="#using-the-command-line">#</a> </h2> <p>Install JDK 17 and the Android SDK. Make sure that <code>JAVA_HOME</code> and <code>ANDROID_HOME</code> are set correctly.</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>git clone https://github.com/jrpie/Launcher </span></span><span style="display:flex;"><span>cd Launcher </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>./gradlew assembleDefaultRelease </span></span></code></pre></div><p>This will create an apk file at <code>app/build/outputs/apk/default/release/app-default-release-unsigned.apk</code>.</p> <p>Note that you need to sign it:</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>apksigner sign --ks <span style="color:#e6db74">&#34;</span>$YOUR_KEYSTORE<span style="color:#e6db74">&#34;</span> <span style="color:#ae81ff">\ </span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span> --ks-key-alias <span style="color:#e6db74">&#34;</span>$YOUR_ALIAS<span style="color:#e6db74">&#34;</span> <span style="color:#ae81ff">\ </span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span> --ks-pass<span style="color:#f92672">=</span><span style="color:#e6db74">&#34;pass:</span>$YOUR_PASSWORD<span style="color:#e6db74">&#34;</span> <span style="color:#ae81ff">\ </span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span> --key-pass<span style="color:#f92672">=</span><span style="color:#e6db74">&#34;pass:</span>$YOUR_PASSWORD<span style="color:#e6db74">&#34;</span> <span style="color:#ae81ff">\ </span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span> --alignment-preserved <span style="color:#ae81ff">\ </span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span> --v1-signing-enabled<span style="color:#f92672">=</span>true <span style="color:#ae81ff">\ </span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span> --v2-signing-enabled<span style="color:#f92672">=</span>true <span style="color:#ae81ff">\ </span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span> --v3-signing-enabled<span style="color:#f92672">=</span>true <span style="color:#ae81ff">\ </span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span> --v4-signing-enabled<span style="color:#f92672">=</span>true <span style="color:#ae81ff">\ </span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span> app-default-release-unsigned.apk </span></span></code></pre></div><p>See <a href="https://developer.android.com/build/building-cmdline">this guide</a> for further instructions.</p>

#

https://example.org/docs/changes-fork/ Mon, 01 Jan 0001 00:00:00 +0000 https://example.org/docs/changes-fork/ <h1 id="notable-changes-compared-to-finns-launcher"> Notable changes compared to Finn&rsquo;s Launcher <a class="anchor" href="#notable-changes-compared-to-finns-launcher">#</a> </h1> <p>µLauncher is a fork of <a href="https://github.com/finnmglas/Launcher">finnmglas&rsquo;s app Launcher</a>. Here is an incomplete list of changes:</p> <!--The last commit of the original project is [340ee731](https://github.com/jrpie/launcher/commit/340ee7315293b028c060638e058516435bca296a) The first commit of µLauncher is [cc2e7710](https://github.com/jrpie/launcher/commit/cc2e7710c824549c367d97a81a1646d27c6c8993), which at the time was still intended as a patch for launcher. The decision to create a hard fork was made two years later.--> <ul> <li> <p>Additional gestures:</p> <ul> <li>Back</li> <li>V,Λ,&lt;,&gt;</li> <li>Edge gestures: There is a setting to allow distinguishing swiping at the edges of the screen from swiping in the center.</li> </ul> </li> <li> <p>Compatible with <a href="https://www.android.com/enterprise/work-profile/">work profile</a>, so apps like <a href="https://gitea.angry.im/PeterCxy/Shelter">Shelter</a> can be used.</p>

#

https://example.org/docs/contributing/ Mon, 01 Jan 0001 00:00:00 +0000 https://example.org/docs/contributing/ <h1 id="contributing"> Contributing <a class="anchor" href="#contributing">#</a> </h1> <p>There are several ways to contribute to this app:</p> <ul> <li> <p>You can add or improve <a href="https://toolate.othing.xyz/projects/jrpie-launcher/">translations</a>. <br><img src="https://toolate.othing.xyz/widget/jrpie-launcher/launcher/horizontal-auto.svg" alt="translation status"></p> </li> <li> <p>If you found a bug or have an idea for a new feature you can <a href="https://s.jrpie.de/launcher-chat">join the chat</a> or open an <a href="https://github.com/jrpie/Launcher/issues/">issue</a>.</p> <blockquote> <p>Please note that I work on this project in my free time. Thus I might not respond immediately and not all ideas will be implemented.</p></blockquote> </li> <li> <p>You can implement a new feature yourself:</p>

#

https://example.org/docs/home/ Mon, 01 Jan 0001 00:00:00 +0000 https://example.org/docs/home/ <h1 id="welcome-to-the-μlauncher-documentation"> Welcome to the μLauncher Documentation <a class="anchor" href="#welcome-to-the-%ce%bclauncher-documentation">#</a> </h1> <h2 id="what-is-μlauncher"> What is μLauncher? <a class="anchor" href="#what-is-%ce%bclauncher">#</a> </h2> <p>µLauncher is an <em>minimal</em> and <em>distraction-free</em> Android home screen that lets you launch apps using <a href="https://example.org/actions-and-gestured.md">swipe gestures and button presses</a>.</p> <p>This project is a fork of <a href="https://github.com/finnmglas/Launcher">finnmglas&rsquo;s app Launcher</a>. An incomplete list of changes can be found <a href="https://github.com/wassupluke/Launcher/blob/master/docs/launcher.md">here</a>.</p> <h2 id="where-can-i-get-μlauncher"> Where can I get μLauncher? <a class="anchor" href="#where-can-i-get-%ce%bclauncher">#</a> </h2> <p><a href="https://f-droid.org/packages/de.jrpie.android.launcher/"><img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" alt="Get it on F-Droid" /></a></p> <p><a href="https://accrescent.app/app/de.jrpie.android.launcher.accrescent"><img src="https://accrescent.app/badges/get-it-on.png" alt="Get it on Accrescent" /></a></p> <p><a href="https://apps.obtainium.imranr.dev/redirect?r=obtainium://app/%7b%22id%22:%22de.jrpie.android.launcher%22,%22url%22:%22https://github.com/jrpie/Launcher%22,%22author%22:%22jrpie%22,%22name%22:%22%c2%b5Launcher%22,%22additionalSettings%22:%22%7b%5c%22apkFilterRegEx%5c%22:%5c%22release%5c%22,%5c%22invertAPKFilter%5c%22:false,%5c%22about%5c%22:%5c%22%c2%b5Launcher%20is%20a%20minimal%20home%20screen.%5c%22%7d%22%7d"><img src="https://raw.githubusercontent.com/ImranR98/Obtainium/b1c8ac6f2ab08497189721a788a5763e28ff64cd/assets/graphics/badge_obtainium.png" alt="Get it on Obtainium" /></a></p> <p><a href="https://github.com/jrpie/launcher/releases/latest"><img src="https://raw.githubusercontent.com/NeoApplications/Neo-Backup/034b226cea5c1b30eb4f6a6f313e4dadcbb0ece4/badge_github.png" alt="Get it on GitHub" /></a></p>

#

https://example.org/docs/profiles/ Mon, 01 Jan 0001 00:00:00 +0000 https://example.org/docs/profiles/ <h1 id="work-profile"> Work Profile <a class="anchor" href="#work-profile">#</a> </h1> <p>µLauncher is compatible with <a href="https://www.android.com/enterprise/work-profile/">work profile</a>, so apps like <a href="https://gitea.angry.im/PeterCxy/Shelter">Shelter</a> can be used. Apps from the work profile are shown in the usual app list.</p> <h1 id="private-space"> Private Space <a class="anchor" href="#private-space">#</a> </h1> <p>µLauncher is compatible with <a href="https://source.android.com/docs/security/features/private-space">private space</a>.</p> <p>The private space can be (un)locked by a dedicated action.</p> <p>It is configurable whether apps from private space are</p> <ol> <li>shown in the usual app list (in this case, (un)locking is accessible through a lock icon on the top right of the app drawer) or</li> <li>only shown in a separate list.</li> </ol>

#

https://example.org/docs/settings/ Mon, 01 Jan 0001 00:00:00 +0000 https://example.org/docs/settings/ <h1 id="launcher-settings"> Launcher Settings <a class="anchor" href="#launcher-settings">#</a> </h1> <p>Tweaks and customizations can be made from within the Launcher Settings page.</p> <p>These settings let you change wallpapers, change colors and fonts, enable monochrome app icons, change the app drawer layout, and much more.</p> <p>In the following documentation, &lsquo;app drawer&rsquo; will be used to refer to the &lsquo;All Apps&rsquo;, &lsquo;Favorite Apps&rsquo; and &lsquo;Private Space&rsquo; views.</p> <h2 id="appearance"> Appearance <a class="anchor" href="#appearance">#</a> </h2> <blockquote> <h3 id="choose-a-wallpaper"> Choose a wallpaper <a class="anchor" href="#choose-a-wallpaper">#</a> </h3></blockquote> <p>This triggers Android&rsquo;s mechanism to change the wallpaper using a photos app, file explorer, or native wallpaper setting app. µLauncher uses the system-wide wallpaper, i.e. this change also affects other launchers.</p>