This week has been exciting in regard to Android apps coming out of Catalyst IT. At KohaCon10 next week we are going to use Reed Wade‘s WebScan (more during / after KohaCon10), and Alan McNatty released MaharaDroid on Thursday, October 21, 2010. Both are – of course – open source.
MaharaDroid is a simple app which allows Android users to upload files from their phone to any Mahara installation. At the moment it only works with the developer version of Mahara 1.4. Anybody who wants to trial the integration, can do so at master.dev.mahara.org (testing and not live environment!). I also use that installation for this brief guide.
Feedback, issue reporting, and feature suggestions are greatly appreciated. We already have a few ideas for future releases and would like to hear about others. Visit the project’s homepage to get the ball rolling.
Alan told me that MaharaDroid is heavily based on Flickr Free by Russell Stuart. Russell’s app is also open source and he was happy to give Alan the code. Don’t you just love open source?
1. Install and launch
Install the app from the Android Marketplace or AppBrain and then launch it via the MaharaDroid icon.
2. Set MaharaDroid preferences
When you open the app, you can make certain settings.
3. Enter upload URI
Use the pre-entered URI if you want to upload to master.dev.mahara.org or change it to your server’s address. You must have the developer version of Mahara 1.4 installed to connect MaharaDroid to Mahara.
4. Enter Mahara username
To connect MaharaDroid to the Mahara installation you want to use for uploading your files, enter your Mahara username for authentication.
5. Enter token
The authentication to your Mahara account requires a token instead of a password. This can be a simple word. Once you have uploaded your first file, the token changes to one that is difficult to guess.
After you click OK, the app closes. That’s something that I would like to see changed because I always think that the app crashed.
You also need to enter the same token on your Mahara “Settings” page.
A future release of the app could see a different kind of authentication, e.g. with OAuth.
6. Choose upload folder
You can choose an upload folder. If it doesn’t already exist, it will be created.
7. Take a photo
Take a photo and click on the “share” icon (to the left of the trash bin). True, I could have been a bit more creative with my photo. There’s a better one in the screencast.
8. Share your file
After clicking on the “share” icon, choose with which app you want to share it. In this case, of course, we choose MaharaDroid.
9. Give your file a name
Before you can upload the file to Mahara, you must accept the copyright notice. That is the same as if you uploaded a file to Mahara via your computer.
You can also choose the file name. Click on “Upload” and your file gets transferred if you are online.
For a future release, I would like to see two additional fields: description and also tags. It would be awesome if I could also choose from my existing Mahara tags.
10. Check out your uploaded file on Mahara
Once the upload is finished, you can log on to your Mahara account and check out your uploaded files in “My Files”. There you can add a description and tags.
Do you want a short video demonstration instead? You can watch the MaharaDroid demo.
This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.