The official Habitica Android mobile app can be obtained for free on:
UsageInstall the app. Log in using the same details you use on the Habitica website (either Facebook login or username and password). Report bugs in the Report a Bug guild for simple/straightforward issues. Report more complex issues to GitHub or through the "Report a Bug" option on the About page.
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 or an on-the-go companion to the Habitica website, and while it is possible to use Habitica solely on the app (task completion, chatting, task allocation), some features on website are still the most up-to-date and the app is catching up on it.
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. It is also accessible by pulling right from the left-most part of the screen, and pulling left to collapse it back.
Tabs are a common part of the Android app interface. You can navigate between different tabs by tapping the desired tab name or swiping left or right.
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 and gold a player has; and may also show the amount of hourglass if the player owns any, but will not be displayed at all if the amount is zero. Tapping on your avatar takes you to the Avatar screen. Tapping on your gem count takes you to the Gems & Subscription screen.
The header is displayed on nearly every app screen; however, swiping up to scroll down the screen automatically hides the header to maximize screen space. Scrolling to the top of the screen will restore the header.
TasksEditThe 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 names in the bottom navigation bar or swiping left or right. The Habits page is opened by default when the app is started.
Creating and Managing Tasks Edit
To create a new Habit, Daily, To-Do, or Reward from the mobile app, tap the floating action button (plus icon) in the lower right hand corner of the screen and select the desired type of task. Alternatively, long press the floating action button to create a new task that matches the task tab you're currently viewing. 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, and tags. Additionally:
- 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.
For Rewards, you can enter the Reward name, notes, tags, and the gold point cost.
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, (in the white space), you are brought to an edit page where you can view the details for or edit that item. From this screen, you can also delete the task by tapping the Delete button.
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.
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 the white space or the text box itself.
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.
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. Completed To-Dos tend to hang around for just a while, but after a refresh it is usually gone.
Your current levels of gems, gold, and hourglass 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 Edit
To refresh/sync tasks, tap the overflow icon (three dots) in the top right hand corner of the screen. When the overflow icon does not show a refresh option, e.g. on Tavern or Party chat screen, it is also possible to refresh by pulling down the screen below the Header. Some screen do not have any refresh option and pulling down will not work, namely the Stable and the Equipment screen, but refreshing on other screens or closing and reopening the app will work the same way.
Tap the filter icon (three lines forming a triangle) in the top right hand corner of the screen to bring up the Filters modal. You can filter tasks by tags by checking the boxes next to the tag names. You can also add a tag by tapping "Add new Tag", edit existing tags by tapping "Edit", and delete a tag by tapping the "X" next to the tag you wish to delete while in Edit mode. There are also additional filtering options depending on which task screen is active:
- Habits: All, Weak, Strong
- Dailies: All, Active, Grey
- To-Do's: Active, Scheduled, Completed
- Rewards: All, Weak, Strong (Disclaimer: It does not work, since custom rewards do not have difficulty)
Sidebar OptionsEditFrom this section, user is able to access their Inbox and their Settings.
The Envelope icon will open the Inbox section that shows a list of users from whom you've received, or to whom you've sent, private messages (PMs). Tapping a username shows the messages you've exchanged with that person and allows you to send them a message. On the top right corner, there's a chat bubble icon, and clicking it will open a pop-up that allows you to enter someone's User ID, and directly send a PM to them.
The Settings page provides various options similar to the website, with various sections: Account, App Settings, Daily Reminder, Custom Day Start, Push Notifications, and Maintenance.
By tapping "Profile", allows you to edit your Display Name, add a Photo URL, and edit your About section of your profile.
"Authentication" allows you to edit your Login Name and Email by entering your password before saving the changes. The "Subscription Status" will display your subscription info, as also shown in the Gems & Subscription tab. It also displays the "Danger Zone", under which you can either choose "Reset Account" or "Delete Account".
"API" displays your User ID and API Token that you can copy just by tapping on it. It will also show your QR code for other user to invite you, and a Download button below it.
"Change your class" allows you to change your class and refund your attribute points for 3 gems. Reassigning attribute points can now be done in-app, but sometimes the changes can be partially reverted because of sync errors, so the website could prove to be easier to use for this purpose.
"Fix Character Values" allows you to edit your current stats. If you've encountered a bug or made a mistake that unfairly changed your character, you can manually correct those values here.
"Logout" allows you to immediately log out of your account and brings you to the login page.
App Settings Edit
"First Day of the Week" allows you to set when your week starts.
"Language" allows you to change your app's language. Changing this will change the website to the same language.
"Audio Theme" allows you to turn on/off or change your app's sound effects.
"Set Dailies default to 'due' tab" allows you to change the default display of the Daily tab, between 'Due' and 'All', just like the website.
Daily Reminder Edit
Under this section, you can activate a daily reminder on your phone and specify at what time this reminder appears.
Custom Day Start Edit
Under this section, you can set your custom day start if you want your Dailies to roll over at a different time (the default is midnight). This will show a clock pop-up, along with the minutes settings, but it will not work properly. This is because the website only allow an hourly-based custom day start, and the minutes settings on Android will cause errors.
Push Notifications Edit
Under this 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).
Under this section, you can force the app to reload its content.
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 and the text will be greyed out.
From this page, you can also cast transformation items (i.e., Seafoam, Shiny Seed, Snowball, and Spooky Sparkles) on fellow party members. Transformation items can be bought from the Seasonal Shop when available.
This displays the breakdown of your Character Attributes as well as the toggle for Automatic Allocation, but currently only the Task-Based Allocation works on all platforms. When you have reached level 10 and above, you will be able to assign points to your different attributes. There is a known issue that you can do it before level 10, which will soon be fixed. Upon leveling up, the top part of the screen will display how many points you have, and upward arrow on each attributes to allocate the point, just like the website.
Below this screen, there is a guide to the different attributes, on how each of the stats will affect the game.
The Tavern, your Party, Guilds, and Challenges 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, which displays their avatar; health, experience, and (if level 10 or over) mana bars; level; class; gold; profile description and photo; User ID (that you can copy); battle gear; costume; stats; number of pets and found and mounts tamed; and achievements (not including challenges or quests).
The Tavern is divided into "Inn" and "Chat", with the "Inn" section being updated on the v1.4 release. The different sections in the "Inn" can be collapsed and expanded by clicking on the arrow next to the respective sub-headers. It consists of "World Boss" (when there's an active one), "Check into Inn", "Community Guidelines", "Helpful Links" and "Player Tiers".
World BossEditWhen a world boss is active, this section will appear: clicking the down arrow will collapse the Boss Art, Rage Strikes, and World Boss Description, and clicking the up arrow will expand it. Each of the respective sub-section, can also be collapsed and expanded the same way. The Dysheartener Boss (a type of bug/beetle) can be hidden if the user has a phobia of the depicted insect, by collapsing it.
Below the Boss Art, the name of the boss, its health, your pending damage, rage attack name, and rage bar are displayed. The Rage Strikes section shows the possible 3 strikes, and will be unveiled when the attack occurs. Below that, the current world boss story is written.
Check into InnEditTo Rest in the Inn, tap the orange "Pause Your Dailies" button below the image of Daniel the Bard under the Inn tab. Afterwards, you can un-pause it by clicking the "Re-activate Your Dailies" button.
Community GuidelinesEditThis section links the Community Guidelines (direct link), under which is also explained the importance of Community Guidelines and keeping a welcoming environment for all users.
Helpful LinksEditThis section has two useful button, one to report a bug, and another is for the FAQ. Both will direct you to the respective in-app section, and are not external links. The FAQ button will open the "Help & FAQ" sub-section, found in the sidebar under the "About" section. The Report a Bug button will open the "About", that allows you to send an email to the developer, along with your app's debugging information.
Player TiersEditJust like the Tavern on the website, this shows the contributor tiers and its respective color for user's reference. The colors are changed to follow the website in the v1.4 release. However, instead of the names being in different colors entirely, the name boxes above each messages are the ones being colored accordingly.
Under the Chat tab of the Tavern page, you can access the Tavern Chat. Tavern Chat does not display avatars or profiles next to chat messages, but player names are colored according to their contributor tiers and clicking on account names will open their profile.
Clicking the three dots to the right of each message opens up the option to copy the message to your clipboard (along with its raw markdown formatting) or to flag the message if you think it abuses the Community Guidelines. For your own message, you will also be able to delete it. Clicking the grey +0 box allows you to like that post, and that box will turn green to show your like. The number will increase according to the amount of likes it receives, or decrease when the like button is pressed once again (reversing your own like action). Note that, in Habitica, it is not possible to "dislike" or "downvote" a post.
There are three tabs under the Party page:
- The Party tab, which shows your party's name, description, leader's message, and current quest (including quest progress, pending damage, 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 along with system messages from casting team skills and transformation items, as well as quest progress.
- 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 (sleeping avatar with zzz and closed eyes). Tapping on a member brings up their profile, which displays their avatar; health, experience, and (if level 10 or over) mana bars; level; class; gold; profile description and photo; User ID (that you can copy); battle gear; costume; stats; number of pets and found and mounts tamed; and achievements (not including challenges or quests).
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. By scrolling down to the bottom, you can see a Leave Party button as well.
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 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
The main Guilds page also includes a Public Guilds button, under the list of the Guilds you have joined. 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 by name.
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 if you have previously joined that guild. Otherwise, a guild will have a Join button at the top right corner.
Challenges EditThere are two tabs under the Challenges page:
- The My Challenges tab, which shows a list of challenges you're currently participating in
- The Public tab, which shows a list of challenges you can participate in
Each challenge listing shows the challenge title, the number of gems awarded (in green under the gem icon), the group the challenge belongs under (i.e., Tavern or a guild/party you are a member of), and whether the challenge is an official Habitica challenge. Additionally, challenge listings under the Public tab show the owner of the challenge, the number of challenge participants, and a "Participating" label for challenges you are participating in.
Clicking on the overflow (three-dots) icon on the top right corner on both the My Challenges and Public tabs will give you the option to Create a Challenge, as well as to Refresh. The Filter icon beside it lets you filter the Challenges from your selected Guilds as well as whether you own the challenge or not.Tapping on a challenge under the My Challenges tab brings up a screen showing a short description of the challenge, the gem prize, the number of participants, and the challenge tasks. Tap the door icon in the upper right-hand corner to leave the challenge. Tap "Show more" under the short description for a pop-up with the challenge's full description, tasks, gem prize, and number of participants, as well as a "Leave" button.
The overflow (three-dots) icon will let you to edit the challenge here. But note that only the challenge owner can edit the challenge, so despite seemingly able to edit it, the changes will not be saved at all, unless you own the challenge.
Tapping on a challenge under the Public tab brings up a pop-up showing the challenge's full description, tasks, gem prize, and number of participants, as well as a "Join" button.
Tasks for challenges you are already participating in are shown with the rest of your tasks.
The available features under the Inventory heading are shops, avatar customization, equipment selection, item management, pet and mount management, and gem/subscription purchasing and subscription management.
The Shops page features three tabs, the first one being the Market tab, where you can purchase Class (and no-class) Equipment, Eggs, Hatching Potions (Magic Hatching Potions included during Grand Galas), Food and Saddles. If you are a subscriber, you can also purchase gems with gold through this tab, under the Special section.
The second is the Quests tab, where you can purchase Unlockable Quests for 4 Gems each. These quests are unlockable at certain points of the game and need not be purchased unless they have been used. Note that rebirthing allows you to get some of these quests at different levels too if you do not want to use gems. There is also the Masterclasser Quest Lines section, and all are gold-purchasable scrolls, ranging from 200 to 700 Gold Points. The last section of this tab sells Pet and Mount Quests for 4 Gems each.
The third is the Seasonal Shop tab that only opens during the Grand Galas, and where you can purchase Seasonal Items (eg. Snowball or Spooky Sparkles), this year's Seasonal Equipment using Gold, as well as past year's Seasonal Equipment using Gems.
Lastly, the Time Travelers tab. where you can purchase World Boss Pets and Mounts, along with various Subscriber Items from the past and future, for 1 Hourglass each. It is not advised to buy subscriber items on app for 1 hourglass each, because the website sells the subscriber sets, consists of 2-4 items, for the same price. This is a known issue, and the developers are trying to fix this.
You can customize your avatar's size, shirt, skin, hair color, hair style, bangs, flower, beard, and mustache, as well as change your background. You can buy various backgrounds, designed by Habiticans, by using gems here. Note that the backgrounds are sorted by month, and not year; the free unlockable backgrounds are available at the bottom of the screen. In addition, you can purchase Animal Skins, Rainbow Skins, and Seasonal Skins (when available) under the Skin section; Special Shirts on under the Shirt section, Rainbow Colors and Seasonal Colors (when available) under the Hair Color section; as well as the hairstyle and facial hair.
You can select your battle gear and costume, as well as select whether you would like to wear a costume. The items are not listed in the open, unlike the website, so clicking on each category (Head, Head Accessory, Eyewear, Armour, Back, Body, Weapon, and Shield) under the Battle Gear or Costume section will show you a list of available equipment of that category, along with its image, stats, and description.
The Items page is where you can find your eggs, hatching potions, food, and quests. Additionally, under the Special tab, you can open your monthly mystery item gift if you are a subscriber.
You can sell items, hatch eggs, and invite your party to quests, but you cannot feed your pets from the Items 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). Refresh the page or close and reopen the app if it doesn't appear in your Stable afterwards.
You can also invite your party to a quest by tapping on a quest and then selecting Invite party.
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 growth bars, which pets you used to have (in which case they lack the growth bar and are greyed out), 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 unequip a pet, clicking Use will remove the pet from you avatar. However, this might take a refresh before the pet disappears.
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.
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. Clicking Use on the same mount will unequip it. However, this might take a refresh before the mount disappears.
Gems & Subscription Edit
There are two tabs under the Gems & Subscription page:
- The Gems tab, which allows you to support Habitica by purchasing gems. Currently, you can purchase 4 gems for $0.99 USD, 21 gems for $4.99, 42 gems for $9.99, or 84 gems for $19.99 through the app. This may vary depending on your registered local currency, and the currency conversion could cause the price to increase or decrease. Habitica has partnered with Seeds, an organization that sends micro-loans to entrepreneurs in developing countries, so that when you buy an 84-gem pack, 20% of the purchase goes to a microborrower and 10% goes to Seeds.
- The Subscription tab:
- For non-subscribers, the tab lists the benefits of subscribing and allows you to buy a subscription. You can subscribe in one-month ($4.99), three-month ($14.99), six-month ($29.99), or twelve-month blocks ($47.99).
- For subscribers, the tab lists the benefits of subscribing and shows the status of your subscription, the length of your subscription term, your payment method, and the bonuses you have received as a result of your subscription (i.e., gem cap and number of mystic hourglasses). Depending on your payment method, you may also have the option of cancelling your subscription.
About (heading) Edit
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.
The latest news, as reported by Bailey on the website, can be found here.
Help & FAQ Edit
You can access a list of commonly asked questions. Tapping on each question will give you the corresponding answer. There is also a button to "Reset Justins Walkthrough" which you can click and let Justin explain the basics of the app from the beginning.
About (page) Edit
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, as well as the app version at the bottom.
The Libraries tab provides a list of libraries used by the Habitica app.
You can choose from four types of widgets:
- Habitica Dailies displays and allows you to check off your Dailies.
- Habitica Todo List displays and allows you to check off your To-Dos.
- Habitica Do Habit lets you choose a Habit and display it along with its + and/or - so that you can easily score it without opening the app.
- Habitica Stats shows your health and experience bar, but editing the widget and expanding it will show a full header, with your avatar, mana bar, and gold, as shown in the screenshot below.
If you cannot find the Habitica widgets but are able to see widgets for other apps, check whether your app is on an SD card. If so, try moving the app to your phone (by going to your device Settings --> Applications/Application Manager --> Habitica). As context, on Android, it is possible for a user to move some apps to their phone's SD card and run them from there, to save space on the phone's own storage area. However, some widgets cannot be used if their apps are stored on the SD card.
Help! My App is Misbehaving! Edit
If information is not displaying correctly in your app, or you are unable to perform a function as expected, please try the following steps.
- Check that you have the latest version based on Google Play.
- 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.
- Perform a soft sync by going to Settings (under About in the Menu) and clicking "Reload Content" at the bottom under Maintenance.
- Clear your cache and data
- Log out
- Go to the Settings section on your device
- Go to Applications/Application Manager
- Find the Habitica app
- Clear the cache and data
- Log back in.
- 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. It is in form of an email, with your app version and User ID, and a space for you to write your reports to the app developers.
Reinstalling the app may not fix your issue as Android devices typically keep data after uninstalling.
Challenges Will Not Load / Refresh
|Description:||If you are a member of guilds with many challenges like the 📜 Library of Tasks and Challenges or The Challenge Sandbox, your Challenges tabs will not populate. (Both these guilds have over 60 challenges.) Or, if your Challenges tabs are already populated and then you join guilds like the ones mentioned, the Challenges tabs will not refresh with any changes.|
|Solution:||If you wish to see your challenges in your Challenge tabs, try leaving guilds that have many challenges.|
|habitica-android Issue #717|