README.md

   1 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!
   2
   3 On devices running Android 7.0 (Nougat), Taskbar can also launch apps in freeform windows for a PC-like experience!  No root required!  (see below for instructions)
   4
   5 Taskbar is also fully supported on Chrome OS - use Taskbar as a secondary Android app launcher on your Chromebook!
   6
   7 ## Features
   8 * Start menu - shows you all applications installed on the device, configurable as a list or as a grid
   9 * Recent apps tray - shows your most recently used apps and lets you easily switch between them
  10 * Collapsible and hideable - show it when you need it, hide it when you don't
  11 * Many different configuration options - customize Taskbar however you want
  12 * Pin favorite apps or block the ones you don't want to see
  13 * Designed with keyboard and mouse in mind
  14 * 100% free, open source, and no ads
  15
  16 #### Freeform window mode (Android 7.0+)
  17
  18 Taskbar lets you launch apps in freeform floating windows on Android 7.0 (Nougat).  No root access is required.  Android 8.0 (Oreo) is also supported via an adb shell command.
  19
  20 Simply follow these steps to configure your device for launching apps in freeform mode:
  21
  22 1. Check the box for "Freeform window support" inside the Taskbar app
  23 2. Follow the directions that appear in the pop-up to enable the proper settings on your device
  24 3. Go to your device's recent apps page and clear all recent apps
  25 4. Select an app using Taskbar to launch it in a freeform window
  26
  27 For more information and detailed instructions, click "Help & instructions for freeform mode" inside the Taskbar app.
  28
  29 ## Download
  30 * Google Play (https://play.google.com/store/apps/details?id=com.farmerbb.taskbar)
  31 * F-Droid (https://f-droid.org/repository/browse/?fdid=com.farmerbb.taskbar)
  32 * APKMirror (http://www.apkmirror.com/apk/braden-farmer/taskbar/)
  33
  34 ## How to Build
  35 Prerequisites:
  36 * Windows, Mac, or Linux machine
  37 * JDK 8
  38 * Android SDK
  39 * Internet connection (to download dependencies)
  40
  41 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.
  42
  43 For ROM developers, Taskbar can also be built from source using the included Android.mk file. (For Nougat, use Taskbar version 3.6; for Oreo, use the latest version)
  44
  45 ## Icon Pack Support
  46 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:
  47
  48     Intent intent = new Intent("com.farmerbb.taskbar.APPLY_ICON_PACK");
  49     intent.putExtra("android.intent.extra.PACKAGE_NAME", "com.iconpack.name");
  50     startActivity(intent);
  51
  52 ## Contributors
  53 * Mark Morilla (app logo) (https://plus.google.com/106169552593075739372)
  54 * naofum (Japanese translation)
  55 * HardSer (Russian translation)
  56 * OfficialMITX (German translation)
  57 * Whale Majida (Chinese translation)