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 ## Changelog
  32 To see some of the major new features in the latest Taskbar release, visit the [changelog](https://github.com/farmerbb/Taskbar/blob/master/CHANGELOG.md).
  33
  34 ## Download
  35 Taskbar can be downloaded as a standalone Android app from:
  36
  37 [<img src="https://play.google.com/intl/en_us/badges/images/generic/en_badge_web_generic.png"
  38       alt="Google Play"
  39       height="80"
  40       align="middle">](https://play.google.com/store/apps/details?id=com.farmerbb.taskbar)
  41 [<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png"
  42       alt="F-Droid"
  43       height="80"
  44       align="middle">](https://f-droid.org/packages/com.farmerbb.taskbar/)
  45
  46 Taskbar is also included as part of the following Android distributions for PCs:
  47
  48 * Android-x86 (7.1-rc2 and later) (http://www.android-x86.org)
  49 * Bliss OS (x86 builds) (https://blissroms.com)
  50
  51 ## How to Build
  52 Prerequisites:
  53 * Windows / MacOS / Linux
  54 * JDK 8
  55 * Android SDK
  56 * Internet connection (to download dependencies)
  57
  58 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.
  59
  60 ## Android 10 Desktop Mode support via libtaskbar
  61 Taskbar can now be included as a library inside any third-party launcher, to quickly and easily add Android 10 Desktop Mode support into your existing launcher with no additional setup.
  62
  63 For more information on including Taskbar inside your application, see the [libtaskbar documentation](https://github.com/farmerbb/Taskbar/blob/master/lib/README.md).
  64
  65 ## Icon Pack Support
  66 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:
  67
  68     Intent intent = new Intent("com.farmerbb.taskbar.APPLY_ICON_PACK");
  69     intent.putExtra("android.intent.extra.PACKAGE_NAME", "com.iconpack.name");
  70     startActivity(intent);
  71
  72 ## Contributors
  73 * Mark Morilla (app logo)
  74 * naofum (Japanese translation)
  75 * HardSer (Russian translation)
  76 * OfficialMITX (German translation)
  77 * Whale Majida, utzcoz (Chinese translation)
  78 * Mesut Han (Turkish translation)
  79 * Zbigniew Zienko (Polish translation)
  80
  81 #### Special Thanks
  82 * Mishaal Rahman (xda-developers)
  83 * Jon West (Team Bliss)
  84 * Chih-Wei Huang (Android-x86)