Mobile App for Android: Habitica

Habitica for Android is the official mobile client for Habitica users. It is based on the unofficial Android app created by MagicMicky. The app functions as an add-on to or replacement for the Habitica website.

The options described in the following sections (except the header, which is displayed on nearly every app screen) are available via the menu, which is accessible by pressing the menu button (three horizontal lines) in the top left corner of the app.

Header
Similar to the website header, the Android app header is located at the top of the screen and contains the player's avatar, health and experience bars, and current level and class. Once the player reaches level 10, the header also displays the mana bar. Additionally, the header shows the amount of gems, gold, and silver a player has.

The header is displayed on nearly every app screen; however, swiping up to scroll down the screen automatically hides the header to maximize screen real estate. Scrolling to the top of the screen will restore the header.

Tasks
The Tasks entry is the first option listed in the menu. You can create, check off, and edit Habits, Dailies, To-Dos, and Rewards via the app. You can navigate between the different pages for each type of task by tapping on their respective tab names or swiping left or right. The Habits page is opened by default when the app is started.

Creating and Editing Tasks
To create a new Habit, Daily, To-Do, or Reward from the mobile app, tap the plus icon in the lower right hand corner of the screen and select the desired type of task. This will cause an Add page to pop up. Depending on the type of task to be created, the page has different fields and options available. The following options are available for all tasks: text (i.e., task name/title), notes, difficulty, tags, and attribute (for task-based attribute allocation). Additionally: For Rewards, you can enter the Reward name, notes, tags, and the gold point cost.
 * For Habits, you can set positive and/or negative actions.
 * For Dailies, you can add a checklist and set the frequency, applicable day(s), start date, and reminders.
 * For To-Dos, you can add a checklist, set the due date, and add reminders.

Once the desired information is inserted, press save in the upper right hand corner to create the task or reward. To cancel adding the task or reward, tap the left arrow in the upper left hand corner of the screen.

When you tap on a Habit, Daily, To-Do, or Reward, you are brought to an edit page where you can view the details for or edit that item.

To reorder your tasks, simply tap and hold on the task you wish to move and drag it to the desired place.

To dismiss the pop up for adding tasks and rewards, you can either tap the X icon or swipe up or down to scroll the screen.

Habits
Your Habits are listed under the Habits tab. You can tap the + or - as you normally would on the website to score a good or bad Habit, respectively. Habits can be edited by tapping on them.

Dailies
Your Dailies are listed under the Dailies tab, with streaks displayed for each Daily. You can check off your Dailies by tapping the respective checkboxes to the left of the Daily names. Dailies can be edited by tapping on them.

Checklists can be created from the edit menu as on the website. They are accessed once you've added them by tapping the small colored checklist progress button on the right side of the Daily to expand the checklist. From the expanded checklist, items can be ticked off normally. When all checklist items are ticked, the progress button turns grey.

To-Dos
Your To-Dos tab contains only incomplete To-Dos. If you have set due dates for any To-Dos, those due dates are shown. You can check off your To-Dos by tapping the respective checkboxes, and checklists can be accessed by tapping the small colored checklist progress button on the right side of the To-Do. To-Dos can be edited by tapping on them. Currently, completed To-Dos are not available in the app.

Rewards
Under Rewards, you can see and purchase unowned equipment, Health Potions, custom Rewards, and the Enchanted Armoire.

You cannot currently use Skills through the Rewards tab, but they are available in the mobile app as their own menu option (see the Skills section below).

Your current levels of gems, gold, and silver are displayed at the top of the screen in the header. Swipe down to reveal them if they are not already visible.

Refreshing and Filtering Tasks
To refresh/sync tasks, tap the circular refresh icon on the top right hand corner of the screen. To filter tasks by tags, select the triangle to the left of the refresh icon to display the Filter by Tag pane and tap on the tags you want to see. You can also add, edit, and delete tags through the Filter by Tag pane.

Skills
You can cast Skills from the mobile app by selecting the Skills option menu, under Tasks. For each skill, the name, description, and mana point cost are shown. Tap the mana point cost to cast a skill.

If you do not have enough mana to use a Skill, the mana point cost will be greyed out.

Social
Your Inbox, the Tavern, your Party, and Guilds can be accessed via the app. They are found under the Social heading of the menu. Tapping a user's name on one of the Social pages brings you to their profile.

You cannot join new challenges via the app, but tasks for challenges you are already participating in are shown with the rest of your tasks.

Inbox
The Inbox page shows a list of users from whom you've received, or to whom you've sent, private messages. Tapping a username shows the messages you've exchanged with that person and allows you to send them a message.

Tapping the speech bubble icon in the top right corner allows you to send a message to a recipient if you know their User ID or QR Code.

Tavern
Under the Chat tab of the Tavern page, you can access the Tavern Chat and have the option of resting in the Inn. Tavern Chat does not display avatars or profiles next to chat messages, but player names are colored according to their contributor tiers. To Rest in the Inn, tap the "Pause Your Dailies" button next to the image of Daniel the Bard in the Inn.

When a world boss is active, the World Quest tab displays information about the world boss, including the boss's name, image, and description, as well as the current values of its Health and Rage bars.

Party
There are three tabs under the Party page: You can navigate to different tabs by tapping the desired tab or swiping left or right.
 * The Party tab, which shows your party's name, description, leader's message, and current quest (including quest progress, participants, and options to accept/reject quest invites or begin/abort/cancel a quest if you are the quest owner)
 * The Chat tab, which shows chat messages from your fellow party members
 * The Members tab, which shows information about each member, including their avatar, name, level, class, and current health, as well as an indication on their avatar of whether they are in the Inn.

The Party chat, like Tavern Chat, does not display avatars or profiles next to chat messages, but player names are colored according to their contributor tiers.

The Party page has an overflow button (icon with three dots) in the top right corner that provides a menu with an option to invite friends via email address, User ID, or QR Code. If you are the party leader, this menu also contains an option to edit the party's name and description. If you are not the party leader, it has an option to leave the party.

Guilds
The Guilds page shows a list of guilds you have joined. Clicking on one brings you to the individual guild page, which has two tabs: The main Guilds page also includes a Public Guilds button. Clicking on it brings you to a list of public guilds and allows you to join any public guilds in which you are interested. You can tap the magnifying glass icon in the top right corner to search the list of public guilds.
 * The Guild tab, which shows the guild's name, description, and leader's message
 * The Chat tab, which shows chat messages from your fellow guild members

Individual guild pages each have an overflow button (icon with three dots) in the top right corner that provides a menu with the option to leave the guild.

Inventory
The available features under the Inventory heading are shops, avatar customization, equipment selection, item management, pet and mount management, and gem purchasing.

Shops
The Shops page features three tabs, the first one being the Market tab, where you can purchase Eggs, Hatching Potions, and Food. The second is the Quests tab, and the third is the Seasonal Shop tab.

Avatar
You can customize your avatar, as well as purchase new avatar customizations with gems.

Equipment
You can select your Battle Gear and costume, as well as select whether you would like to wear a costume.

Items
The Items page is where you can find your eggs, hatching potions, food, and quests. You can sell items, hatch eggs, and invite your party to quests, but you cannot feed your pets from this screen. (Feeding is instead done via the Pets screen.) The number of each item you have is shown below the item name in grey.

You can sell any item by tapping on it and tapping the red Sell (x Gold) option that pops up. You can hatch eggs by tapping an egg, selecting the Hatch with potion option that pops up, and then tapping the hatching potion you would like to pour over them (or vice versa, starting with a hatching potion).

You can also invite your party to a quest by tapping on a quest and then selecting Invite party.

Stable
The stable is where you can find your pets and mounts.

Pets
The Pets tab is where you can find all your pets, sorted by category (e.g., Base, Quest, Rare), and then listed by type (e.g., Bear Cub, Cactus, Cheetah, Octopus). For each type of pet, the page will show the name, the image of the base pet, and the number of pets of that type that you have hatched.

By tapping on a type of pet, you are taken to a screen that shows you which pets you have and their hunger bars, which pets you used to have (in which case they lack the hunger bar), and which pets you have not yet hatched (these are indicated with a paw icon with a question mark in it).

To equip a pet, tap the pet you would like to equip and choose Use when that option pops up.

To feed a pet, tap the pet you would like to feed and then select Feed. You will be taken to a pop-up with a list of the foods you have; then, select the desired food. You can tap anywhere outside of the pop-up if you would no longer like to feed the pet.

Mounts
Similarly to the Pets page, the Mounts page is where you can find all your mounts, sorted by category and then listed by type. For each type of mount, the following is shown: name, image of base mount, and number of mounts you have tamed of that type. If you have not yet tamed a mount of that type, the icon of the paw with the question mark will be shown.

You can ride a mount by tapping on the desired mount and selecting Use when the option pops up.

Purchase Gems
You can support Habitica by purchasing gems. Currently, you can purchase 21 gems for $5.00 USD through the app.

About (heading)
Under the About heading, the available features allow you to view the news, access settings, find a list of frequently asked questions, and get more information about the app.

News
The latest news, as reported by Bailey on the website, can be found here. Older news can be accessed by tapping on "Read older news" at the end of the most recent news.

Settings
The Settings page provides options for viewing your account details, changing your class, changing your language, setting the first day of the week, logging out, setting a daily reminder, and setting up push notifications.

By tapping on "Account Details", you can view (but not edit) your login name, e-mail, user ID, API token, and QR code. You can copy your account details (except QR code) to your clipboard by tapping on them. Tapping on the "Your QR Code" option displays your QR code and allows you to save a copy of it to your phone

"Change your class" allows you to change your class and refund your attribute points for 3 gems. Reassigning attribute points requires accessing the website.

"Language" allows you to change your app's language.

"First Day of the Week" allows you to set when your week starts.

"Logout" allows you to immediately log out of your account and brings you to the login page.

Under the "Daily Reminder" section, you can activate a daily reminder on your phone and specify at what time this reminder appears.

Under the "Push Notifications" section, you can select whether you'd like to receive push notifications and specify which ones you'd like to receive (i.e., when you win a challenge, receive a private message, are gifted gems, are gifted a subscription, are invited to a party, are invited to a guild, are part of a quest that has just begun, or are invited to a quest).

Help & FAQ
You can access a list of commonly asked questions. Tapping on each question will give you the corresponding answer.

About (page)
The About page has two tabs: About and Libraries.

In the main section of the About page (the About tab), there are buttons to rate the app on Google Play, report a bug, send feedback, and access the Github source code page.

The Libraries tab provides a list of libraries used by the Habitica app.

Help! My App is Misbehaving!
If information is not displaying correctly in your app, or you are unable to perform a function as expected, please try the following steps. Reinstalling the app may not fix your issue as Android devices typically keep data after uninstalling.
 * 1) Check that you have the latest version based on Google Play.
 * 2) Ensure the developer option "Do not keep activities" is turned off. This will only be available if you have enabled developer options on your phone.
 * 3) Perform a soft sync by changing your avatar's t-shirt color.
 * 4) Clear your cache and data by:
 * 5) * Logging out
 * 6) * Going to the Settings section on your device
 * 7) * Going to Applications/Application Manager
 * 8) * Finding the Habitica app
 * 9) * Clearing the cache and data
 * 10) * Logging back in.
 * 11) If all the steps above fail, report the bug in the Report a Bug guild, on GitHub, or in the app under About -> Report a Bug. The third option is often preferred as it automatically captures your device information and the report is sent directly to the developer to analyze.

fr:Application mobile pour Android: Habitica