1 line
No EOL
17 KiB
JSON
1 line
No EOL
17 KiB
JSON
[{"id":0,"href":"/chat/","title":"Chat","section":"Home","content":" Chat # The chat is bridged across Matrix and Discord, so you can choose your preferred platform:\nMatrix1 (recommended) Discord Matrix is a decentralized messenger, for an introduction see joinmatrix.org\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/donate/","title":"Donate","section":"Home","content":" Donate # Thank you for considering to donate to μLauncher!\nμLauncher is charityware.1 Please send your donations to Brot für die Welt (\u0026quot;bread for the world\u0026quot;):\nIBAN:DE10 1006 1006 0500 5005 00 BIC:GENODED1KDB Copy IBAN μLauncher is not affiliated to Brot für die Welt in any official way.\nFAQ # What does Brot für die Welt use the donations for? # Their main topics include food security, human rights, education and mitigating the climate crisis. They also campaign for legislation in Germany, e.g. the supply chain act. See this page for an overview. More than 90% of donations are used for project work.\nHow much should I donate? # As much as you like! Similar software costs about 5 - 40€ for a lifetime subscription, you can use that as a frame of reference.\nI cannot afford a donation. Can I use μLauncher anyway? # Yes.\nCan I donate to the developer of μLauncher? # No. I work on this as a hobby project. My financial situation is currently very good: There are no tuition fees in Germany (!), my student apartment is quite cheap and I get a scholarship. Money is needed more urgently elsewhere. I\u0026rsquo;m very grateful that you want to donate, but I don\u0026rsquo;t really need money for myself, so please donate to Brot für die Welt instead.\nAre there other ways to contribute? # Yes!\nInspired by the business model of the formidable text editor vim. RIP Bram Moolenaar!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/actions-and-gestures/","title":"Actions and Gestures","section":"Docs","content":" Actions and Gestures # µLauncher\u0026rsquo;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 \u0026gt; ACTIONS.\nAvailable Gestures # Swipes # Basic swipes: Swipe up, down, left, or right\nDouble swipes: Swipe up, down, left, or right with two fingers\nEdge swipes:\nSwipe up or down on the left or right edge Swipe left or right on the top or bottom edge 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.\nTaps # Tap on date or time Double tap Long click Tap-then-Swipes # Tap then swipe up, down, left, or right\nTo execute these gesture consistently, it is helpful to think of them as double taps, where the finger stays on the screen after the second tap and then does a swipe. The swipe must start very shortly after the tap ended.\nComplex Gestures # Draw \u0026lt;, \u0026gt;, V, or Λ Draw \u0026lt;, \u0026gt;, V, or Λ in reverse direction Hardware Buttons as Gestures # Back button (or back gesture if gesture navigation is enabled) Volume buttons Available Actions # To any of the available gestures, one of the following actions can be bound:\nLaunch an app (or a pinned shortcut) Open a widget panel. Widget panels can hold widgets that are not needed on the home screen itself. They can be created and managed in µLauncher Settings \u0026gt; Manage Widget Panels Open a list of all, favorite, or private apps (hidden apps are excluded). Actions related to private space are only shown if private space is set up on the device. µLauncher\u0026rsquo;s settings can be accessed from those lists. If private space is set up, an icon to (un)lock it is shown on the top right. Open µLauncher\u0026rsquo;s settings Toggle private space lock Lock the screen: This allows to lock the screen. There are two mechanisms by which the screen can be locked, accessibility service and device admin. Toggle the flashlight Raise, lower or adjust volume Play or pause media playback Skip to previous or next audio track Open notifications panel: Might be useful if the top of your screen is broken. Open quick settings panel: Why swipe down twice? Open recent apps: Requires accessibility service. Can be used as a workaround for a Android bug. Launch another home screen: Allows using another installed home screen temporarily. Do nothing: Just prevents showing the message saying that no action is bound to this gesture. "},{"id":3,"href":"/docs/alternatives/","title":"Alternatives","section":"Docs","content":"TODO: move the hedgedoc document here.\n"},{"id":4,"href":"/docs/build/","title":"Build","section":"Docs","content":" Building from Source # Using the command line # Install JDK 17 and the Android SDK. Make sure that JAVA_HOME and ANDROID_HOME are set correctly.\ngit clone https://github.com/jrpie/Launcher cd Launcher ./gradlew assembleDefaultRelease This will create an apk file at app/build/outputs/apk/default/release/app-default-release-unsigned.apk.\nNote that you need to sign it:\napksigner sign --ks \u0026#34;$YOUR_KEYSTORE\u0026#34; \\ --ks-key-alias \u0026#34;$YOUR_ALIAS\u0026#34; \\ --ks-pass=\u0026#34;pass:$YOUR_PASSWORD\u0026#34; \\ --key-pass=\u0026#34;pass:$YOUR_PASSWORD\u0026#34; \\ --alignment-preserved \\ --v1-signing-enabled=true \\ --v2-signing-enabled=true \\ --v3-signing-enabled=true \\ --v4-signing-enabled=true \\ app-default-release-unsigned.apk See this guide for further instructions.\nUsing Android Studio # Install Android Studio, import this project and build it.\nSee this guide for further instructions. How to\nCI Pipeline # The CI pipeline automatically creates debug builds.\nNote: These builds are not signed. They are in built in debug mode and only suitable for testing.\n"},{"id":5,"href":"/docs/contributing/","title":"Contributing","section":"Docs","content":" Contributing # There are several ways to contribute to this app:\nYou can add or improve translations. If you found a bug or have an idea for a new feature you can join the chat or open an issue.\nPlease note that I work on this project in my free time. Thus I might not respond immediately and not all ideas will be implemented.\nYou can implement a new feature yourself:\nCreate a fork of this repository. Create a new branch named feature/\u0026lt;your feature\u0026gt; or fix/\u0026lt;your fix\u0026gt; and commit your changes. Open a new pull request. See here for instructions how to build this project. The CI pipeline automatically creates debug builds.\n"},{"id":6,"href":"/docs/home/","title":"Home","section":"Docs","content":" Welcome to the μLauncher Documentation # What is μLauncher? # µLauncher is an minimal and distraction-free Android home screen that lets you launch apps using swipe gestures and button presses.\nThis project is a fork of finnmglas\u0026rsquo;s app Launcher. An incomplete list of changes can be found here.\nWhere can I get μLauncher? # You can also get it on Google Play, but this is not recommend.\nHow can I contribute? # See docs/contribute\nScreenshots # "},{"id":7,"href":"/docs/profiles/","title":"Profiles","section":"Docs","content":" Work Profile # µLauncher is compatible with work profile, so apps like Shelter can be used. Apps from the work profile are shown in the usual app list.\nPrivate Space # µLauncher is compatible with private space.\nThe private space can be (un)locked by a dedicated action.\nIt is configurable whether apps from private space are\nshown 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 only shown in a separate list. "},{"id":8,"href":"/docs/settings/","title":"Settings","section":"Docs","content":" Settings # Tweaks and customizations can be made from within the settings page. The settings can be opened by binding the Settings action to a gesture (this is especially useful when configuring μLauncher for the first time) or from the settings icon in the app drawer.1\nAppearance # Choose a wallpaper # This triggers Android\u0026rsquo;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.\nFont (in-app font) # Set the font used within the app settings. This setting does not affect the date/time home screen font.\ntype: dropdown\noptions: Hack,System default,Sans serif,Serif,Monospace,Serif monospace\nText Shadow # type: toggle\nBackground (app list and setting) # type: dropdown\ntype: Transparent,Dim,Blur,Solid\nMonochrome app icons # Remove coloring from all app icons. Can help decrease visual stimulus when enabled.\ntype: toggle\nDate \u0026amp; Time # These settings effect the clock shown on the home screen (or on widget panels). If the clock is removed, the settings are not used.\nFont (home screen) # Set the home screen font for date and time. This setting does not affect the font of other components.\ntype: dropdown\noptions: Hack,System default,Sans serif,Serif,Monospace,Serif monospace\nColor # Set the color for the home screen date and time.\nAccepts an 6 digit RGB or or 8 digit ARGB color code characters.2 Note that on Android the ARGB color format is used, i.e. the alpha component is specified first. This differs from the more common RGBA, which is used in web development.\ntype: ARGB\nUse localized date format # Adapt the display of dates and times to the specific conventions of a particular locale or region as set by the system. Different locales use different date orders (e.g., MM/DD/YYYY in the US, DD/MM/YYYY in Europe).\ntype: toggle\nShow time # Show the current time on the home screen.\ntype: toggle\nShow seconds # Show the current time down to the second on the home screen.\ntype: toggle\nShow date # Show the current date on the home screen.\ntype: toggle\nFlip date and time # Place the current time above the current date on the home screen.\ntype: toggle\nFunctionality # Launch search results # Launches any app that matches user keyboard input when no other apps match.\nAs you type inside the app drawer, the app narrows down the list of apps shown based on the app title matching your text input. With the \u0026rsquo;launch search results\u0026rsquo; setting, once only one matching app remains, it is launched immediately. Usually it suffices to type two or three characters the single out the desired app.\nThis feature becomes more powerful when combined with renaming apps, effectively letting you define custom app names that could be considered \u0026lsquo;aliases\u0026rsquo; or shortcuts. For instance, if you want the keyboard input gh to open your GitHub app, you could rename GitHub to GitHub gh, gh GitHub, or simply gh. Assuming no other installed apps have the gh combination of letters in them, opening the app drawer and typing gh would immediately launch your GitHub app.\nPress space to temporarily disable this feature and allow text entry without prematurely launching an app. Useful when combined with the Search the web feature.\ntype: toggle\nSearch the web # Press return while searching the app list to launch a web search.\ntype: toggle\nStart keyboard for search # Automatically open the keyboard when the app drawer is opened.\ntype: toggle\nDouble swipe gestures # Enable double swipe (two finger) gestures in launcher settings. Does not erase gesture bindings if accidentally turned off.\ntype: toggle\nEdge swipe gestures # Enable edge swipe (near edges of screen) gestures in launcher settings. Does not erase gesture bindings if accidentally turned off.\ntype: toggle\nEdge width # Change how large a margin is used for detecting edge gestures. Shows the edge margin preview when using the slider.\ntype: slider\nChoose method for locking the screen # There are two methods to lock the screen and unfortunately both have downsides.\nDevice Admin\nDoesn\u0026rsquo;t work with unlocking by fingerprint or face recognition. Accessibility Service\nRequires excessive privileges. μLauncher will use those privileges only for locking the screen. As a rule of thumb, it is not recommended to grant access to accessibility services on a random app. Always review the source code before granting accessibility permissions so you familiarize yourself with what the code might do. On some devices, the start-up PIN will no longer be used for encrypting data after activating an accessibility service. This can be reactivated afterwards. type: text buttons\noptions: USE DEVICE ADMIN,USE ACCESSIBILITY SERVICE\nApps # Hidden apps # Open an app drawer containing only hidden apps.\nDon\u0026rsquo;t show apps that are bound to a gesture in the app list # Remove certain apps from the app drawer if they are already accessible via a gesture.\nReduces redundancy and tidies up app drawer.\ntype: toggle\nHide paused apps # Remove paused apps from the app drawer. For example an app belonging to the work profile is paused when the work profile is inactive.\ntype: toggle\nHide private space from app list # Remove private space from app drawer. Private space apps can be accessed using a separate app drawer which can be opened with the Private Space action.\ntype: toggle\nLayout of app list # Changes how the apps are displayed when accessing the app drawer.\nDefault: All apps in the drawer will show in a vertically-scrolled list with their app icon and title. Text: Removes the app icons, shows only app titles in the drawer as a vertically-scrolled list. Work profile and private space apps are distinguished by a different label instead of a badge. Grid: Shows apps with their app icon and title in a grid layout. type: dropdown\noptions: Default,Text,Grid\nReverse the app list # Enable reverse alphabetical sorting of apps in the app drawer. Useful for keeping apps within easier reach from the keyboard.\ntype: toggle\nDisplay # Rotate screen # type: toggle\nKeep screen on # type: toggle\nHide status bar # Remove the top status bar from the home screen.\ntype: toggle\nHide navigation bar # Remove the navigation bar from the home screen. Enabling this setting may make it difficult to use the device if gestures are not setup properly.\ntype: toggle\nAdditional Settings # App Drawer Long Press on App # Access additional per-app details and settings. To use, open the app drawer and long press on any app.\ntype: dropdown\noptions: App Info,Add to favorites,Hide,Rename,Uninstall\ni.e. the \u0026lsquo;All Apps\u0026rsquo;, \u0026lsquo;Favorite Apps\u0026rsquo; and \u0026lsquo;Private Space\u0026rsquo; views.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nMore precisely, everything that is vaild input for parseColor can be used.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":9,"href":"/docs/changes-fork/","title":"Differences to the original Launcher","section":"Docs","content":" Notable changes compared to Finn\u0026rsquo;s Launcher # µLauncher is a fork of finnmglas\u0026rsquo;s app Launcher. Here is an incomplete list of changes:\nAdditional gestures:\nBack V,Λ,\u0026lt;,\u0026gt; Edge gestures: There is a setting to allow distinguishing swiping at the edges of the screen from swiping in the center. Compatible with work profile, so apps like Shelter can be used.\nCompatible with private space\nSupport for app widgets\nSupport for pinned shortcuts\nOption to rename apps\nOption to hide apps\nFavorite apps\nNew actions:\nToggle Torch Lock screen Open a widget panel The home button now works as expected.\nImproved gesture detection.\nVisual # This app uses the system wallpaper instead of a custom solution. The font has been changed to Hack, other fonts can be selected. Font Awesome Icons were replaced by Material icons. The gear button on the home screen was removed. A smaller button is show at the top right when necessary. Search # The search algorithm was modified to prefer matches at the beginning of the app name, i.e. when searching for \u0026quot;te\u0026quot;, \u0026quot;termux\u0026quot; is sorted before \u0026quot;notes\u0026quot;. The search bar was moved to the bottom of the screen. Technical # Improved gesture detection. Different apps set as default. Package name was changed to de.jrpie.android.launcher to avoid clashing with the original app. Dropped support for API \u0026lt; 21 (i.e. pre Lollypop) Fixed some bugs Some refactoring The complete list of changes can be viewed here.\n"},{"id":10,"href":"/docs/widgets/","title":"Widgets","section":"Docs","content":" Widgets # μLauncher allows to add app widgets to the home screen and to widget panels.\nWidgets can be added, moved, removed and configured in Settings \u0026gt; Manage Widgets.\nIt is configurable whether or not interaction with a widget should be enabled.\nIf interaction is enabled, touch events are forwarded to the widget as usual. However, μLauncher gestures can not be executed in areas where such a widget is present.\nIf interaction is disabled, the widget does not respond to any touch events. This is recommended when using a widget only to display information.\nμLauncher\u0026rsquo;s clock behaves similar as an app widget and can be managed in the same way.1\nWidget Panels # Widget panels can contain widgets that are not needed on the home screen. They can be managed in Settings \u0026gt; Manage Widget Panels. Widget panels can be opened by using the Open Widget Panel action.\nHowever, it is technically not an app widget and cannot be used with other launchers.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"}] |