README.md

   1 ![Taskbar](http://i.imgur.com/gttRian.png)
   2
   3 Taskbar puts a start menu and recent apps tray on top of your screen that's accessible at any time, increasing your productivity and turning your Android tablet (or phone) into a real multitasking machine!
   4
   5 On devices running Android 7.0+, Taskbar can also launch apps in freeform windows for a PC-like experience!  No root required!  (see below for instructions)
   6
   7 Taskbar is also fully supported on Chrome OS - use Taskbar as a secondary Android app launcher on your Chromebook!
   8
   9 ## Features
  10 * Start menu - shows you all applications installed on the device, configurable as a list or as a grid
  11 * Recent apps tray - shows your most recently used apps and lets you easily switch between them
  12 * Collapsible and hideable - show it when you need it, hide it when you don't
  13 * Many different configuration options - customize Taskbar however you want
  14 * Pin favorite apps or block the ones you don't want to see
  15 * Designed with keyboard and mouse in mind
  16 * 100% free, open source, and no ads
  17
  18 #### Freeform window mode (Android 7.0+)
  19
  20 Taskbar lets you launch apps in freeform floating windows on Android 7.0+ devices.  No root access is required, although Android 8.0, 8.1, and 9 devices require an adb shell command to be run during initial setup.
  21
  22 Simply follow these steps to configure your device for launching apps in freeform mode:
  23
  24 1. Check the box for "Freeform window support" inside the Taskbar app
  25 2. Follow the directions that appear in the pop-up to enable the proper settings on your device (one-time setup)
  26 3. Go to your device's recent apps page and clear all recent apps
  27 4. Start Taskbar, then select an app to launch it in a freeform window
  28
  29 For more information and detailed instructions, click "Help & instructions for freeform mode" inside the Taskbar app.
  30
  31 ## Download
  32 Taskbar can be downloaded as a standalone Android app from:
  33
  34 [<img src="https://play.google.com/intl/en_us/badges/images/generic/en_badge_web_generic.png"
  35       alt="Google Play"
  36       height="80"
  37       align="middle">](https://play.google.com/store/apps/details?id=com.farmerbb.taskbar)
  38 [<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png"
  39       alt="F-Droid"
  40       height="80"
  41       align="middle">](https://f-droid.org/packages/com.farmerbb.taskbar/)
  42
  43 Taskbar is also included as part of the following Android distributions for PCs:
  44
  45 * Android-x86 (7.1-rc2 and later) (http://www.android-x86.org)
  46 * Bliss OS (x86 builds) (https://blissroms.com)
  47
  48 ## How to Build
  49 Prerequisites:
  50 * Windows / MacOS / Linux
  51 * JDK 8
  52 * Android SDK
  53 * Internet connection (to download dependencies)
  54
  55 Once all the prerequisites are met, make sure that the `ANDROID_HOME` environment variable is set to your Android SDK directory, then run `./gradlew assembleFreeDebug` at the base directory of the project to start the build. After the build completes, navigate to `app/build/outputs/apk/free/debug` where you will end up with an APK file ready to install on your Android device.
  56
  57 ## Icon Pack Support
  58 Taskbar includes support for ADW-style icon packs.  If you are an icon pack developer and would like to include support for applying the icon pack from within your app, simply use the following code:
  59
  60     Intent intent = new Intent("com.farmerbb.taskbar.APPLY_ICON_PACK");
  61     intent.putExtra("android.intent.extra.PACKAGE_NAME", "com.iconpack.name");
  62     startActivity(intent);
  63
  64 ## Contributors
  65 * Mark Morilla (app logo)
  66 * naofum (Japanese translation)
  67 * HardSer (Russian translation)
  68 * OfficialMITX (German translation)
  69 * Whale Majida (Chinese translation)
  70 * Mesut Han (Turkish translation)