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 through 8.1, 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 through 8.1)
  19
  20 Taskbar lets you launch apps in freeform floating windows on Android 7.0 and 7.1 (Nougat).  No root access is required.  Android 8.0 and 8.1 (Oreo) are also supported via an adb shell command.  Versions earlier than 7.0 and later than 8.1 are not supported.
  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. Select an app using Taskbar 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://f-droid.org/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, simply cd to the base directory of the project and run "./gradlew assembleFreeDebug" to start the build.  Dependencies will download and the build will run.  After the build completes, cd to "app/build/outputs/apk" where you will end up with the APK file "app-free-debug.apk", 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) (https://plus.google.com/106169552593075739372)
  66 * naofum (Japanese translation)
  67 * HardSer (Russian translation)
  68 * OfficialMITX (German translation)
  69 * Whale Majida (Chinese translation)
  70 * Mesut Han (Turkish translation)