Zandy User Guide

What is Zandy?

Zandy is an Android application for working with a Zotero library on your Android device (for now, it needs to be running Android 2.2 or later). The goal is to do everything that Zotero itself can do, but for now we’re settling for viewing, modifying, adding references, viewing and modifying notes, and viewing attachments.

Zandy can be downloaded from the Android Market and the Amazon App Store. Note that the version in the Amazon App Store may at times be a little older, due to the store’s review process.

And what’s Zotero? Zotero is the greatest piece of research management software out there, mainly because it’s the only one with a fanatic community around it, providing support for thousands of academic and non-academic websites, and great plugins for everything from word processing to mapping to file management.

Logging In

When you first open Zandy, the first thing you’ll see is the basic main menu, with three large, bland buttons: “View Collections”, “View Items” and “Log In”. No frills, just those three.

Main screen, with the basic functions of Zandy.

Before working with your library, you’ll need to connect Zandy to your Zotero account. To do this, press the “Log in” button. You’ll be sent to the Zotero webpage to give permission for the application to access your data. Just enter your username and password as usual, and accept the authorization request. Note that for Zandy to work fully with your Zotero library, you’ll need to give it write access to your library. To do so, click red “Change Permissions” button, and check the boxes “Allow notes access” and “Allow write access”. Then click “Accept Defaults” at the top of the page (yes, even if you’ve already modified the permissions).

Make sure to check “Allow write access” and “Allow notes access” if you plan on using Zandy for either feature. Also, click “Accept Defaults” to save and go back to Zandy.

Note: It’s important that you just accept or decline the request from Zandy when on the Zotero site, since the authorization process will be interrupted if you, say, decide to browse your library at zotero.org, or even log in and out.

It isn’t necessary to provide write access and note access, but keep in mind that Zandy will still allow you to create notes and make changes locally, without these changes propagating to the server. This may lead to confusion at times, but the main features should work nonetheless.

If you’re having trouble with this process, there’s a manual way to give Zandy access to your Zotero library: see Setting up and changing Zotero.org credentials in the Extra Tips section below.

Once you’ve logged in, you can actually start a sync with the server and get to work.

Syncing

The menu bar, shown while in the tag view

To start a sync, bring up the menu by pressing your device’s menu button, and touch “Sync”. A message will appear, confirming that a sync has been initiated. The exact data that will be requested from the Zotero server depends a little on what you’re viewing when you initiate a sync, so you should first touch “View Collections” to enter the collections view, then initiate the sync. Zandy will request the full collection list from the server. When you leave the collections view and return to it, the newly loaded collections will be shown.

Minor bug alert: It’s a little inconvenient that the collection list isn’t immediately updated as soon as the sync is complete. This is a general problem with Zandy right now; the interface isn’t usually updated to reflect changes until you leave a screen and come back to it. I’m working on this and hope to eliminate this potentially confusing bit pretty soon. Bear with me.

The general behavior of syncs is that Zandy first sends any locally modified items to the server, such as new items or ones where you’ve edited any fields (more on that later). It then requests updated data for the currently visible collection, if one is being browsed, or for the whole list of collections, if the collection list is being viewed. This means that Zandy doesn’t necessarily always have a complete and up-to-date copy of your library; it instead tries to maintain up-to-date versions of the parts of the library that you’re using.

This behavior can be changed by checking the “Aggressive Syncing” box in Settings. When this is set, Zandy will always attempt to keep the entire library up-to-date. This will mean more traffic.

Navigation

Some of the collections have been synced, and some have not. The unsynced ones will be synced when I attempt to view their items.

Once you have some collections and items synced up, you can start exploring. The main way to move around your library in Zandy is by browsing collections, so we start by touching “View Collections” on the initial Zandy screen. If you’ve successfully synced your library, you should see a list of collections, each with the number of (synced) child items and subcollections, as well as sync status, listed.

Note, however, that you don’t have to navigate by collection; you can tap “View items” to see the whole item list, and initiate a sync from that view to get the entire library. You can then navigate using searches or tags.

To drill down and see the subcollections of a collection, just tap it. To open a collection and view the items in it, touch and hold (long-tap) the collection. If a collection is marked “Partial data”, that means that Zandy hasn’t yet attempted to retrieve an item list for that collection; an attempt to view its items will cause Zandy to issue a sync request.

Note: Collection membership in Zandy works just like in Zotero, which means that a single item can belong to any number of collections, and that a view of the items in a collection will not ordinarily show the items in that collection’s subcollections, unless the items were added to both the subcollection and the parent collection explicitly. This can be a little confusing at times.

Items in a collection. Tap an item to see its details or modify it.

The basic metaphor across Zandy is tap to open, tap-and-hold to edit: Tap a collection to open its subcollections. Tap-and-hold a collection to show its items (OK, that’s not really editing). Tap an item to see its details, tap-and-hold a detail to modify it. Tap the creator summary (list of last names) to get a view of their full names and roles. Tap-and-hold a creator in this view to modify or delete it. Tap the tag list to get a view of the tags and the tag type (automatic, user). Tap-and-hold a tag in that view to modify or delete it.

The other main axis of navigation is simply the back button– it’s the best way to go back to the collection you were viewing, or the item list, etc.

Search items by creator or title.

Search your library
In addition to the hierarchy of collections, you can use searches to navigate your collection. To search, open the options menu and tap Search. At present, the search is limited to item titles and creators. On devices with a physical search button, press it to initiate a search. Note that searches can only be initiated from item listings, and they do not limit the results to the collection currently being viewed.

Future releases of Zandy will bring support for more search fields and for saved searches.

Editing

A not-very-elegant dialog for creating and modifying item creators

There are several types of editing currently supported by Zandy.

Item Fields. Tap an item in a collection to see its full field list, then tap-and-hold a field. A dialog will pop up to modify the field content.

Creators. Tap the creators when viewing item details to see the full creator list, then tap-and-hold one of the creators. The creator dialog lets you set the creator role, such as Author, Translator or Editor, as well as set the creator’s name using one- or two-field mode. Enter the name in the upper two fields if in two-field mode, or check “Single Field” and enter it in the lower box if single-field mode is intended. In the latter case, the contents of the first two fields will be discarded. You can also delete a creator using the “Delete” button in the dialog.

Tags. Tags work much like creators, but have just one field in their dialog. Tap the tags when viewing item details to see the full tag list, then tap-and-hold one of the tags. Tap a tag to view a list of items with that tag.

Collections. Collections memberships are shown just like tags. Tap a collection in the list to view it or remove that membership, and select “New” from the options menu to add the current item to another collection.

New Items. While viewing an item list, you can create a new item by showing the menu and pressing the “New” button. You will be prompted to choose an item type, then brought to the item details screen. You can also add new items from the browser and by identifier lookup, manually entered or scanned from a bar code. See the sections below.

Item Type. Item type cannot currently be changed from within Zandy. This will be fixed in a later release.

Changes made from within Zandy are synced as described above in “Syncing”.

Notes and Attachments

You can download and view file attachments to your Zotero items. Tap the “Attachments” item in the item details view, then tap the attachment you’re interested in. Once it downloads, it’ll open in an appropriate viewer app on your phone. Once Zotero’s API brings support for modifying attachments, Zandy will support uploads and annotations too. Attachment viewing works for attachments stored in Zotero File Storage or on a WebDAV server. A WebDAV setup requires some more setup– specify the server information in the Zandy preferences. Zandy’s WebDAV support currently doesn’t allow self-signed SSL certificates, so you may need to use HTTP and not HTTPS if you are running your own server (see Ticket #66).

Zandy also does not support HTTP Digest authentication, so you will need to use Basic authentication (see Ticket #130).

To view item notes, tap “Attachments” in the item details view, and tap the desired note to read and edit it. To create a new note, select “New” from the options menu while viewing the attachment list. Note that Zandy does not support rich-text editing of notes, so you may find that many of your notes have a lot of raw HTML tags in them. Sorry about that– a fix is planned, but it may take some time to implement.

Standalone notes are listed alongside regular items, just like in the desktop Zotero client.

Browser Integration

If you find interesting pages while browsing the web, you can send them to Zandy using your device’s “Send Page” function; this will create an webpage item in your library with the page’s title and URL. Zandy can’t yet produce webpage snapshots or run site translators like Zotero proper, but that’s planned too. Since this uses the general “share” intent on Android, you may find that you can send links from other apps too, not just the browser.

Item list options menu. Tap “Add by identifier” to enter the ISBN manually or to start the barcode scanner.

Identifier lookup / Barcode scanning

You can now add items by entering an ISBN manually, or by scanning a bar code. To use this feature, select “Add by identifier” from the options menu while viewing any item list. The item should be added to the currently open collection. The metadata isn’t perfect yet, but it’s a start. A future release, probably in the 1.2.x series, will request better metadata from the Library of Congress catalog when available. This feature uses the great zxing library, and it’ll prompt you to install a bar code reader if it’s not already installed on your device.

When the new item has been fetched, Zandy will open the item details view to make any further changes, rather like the integration with the browser’s Send function.

The ISBN lookup is limited by the scope of WorldCat’s index, so you may find that some non-Western publications are not found.

Extra Tips

Synchronization settings. WebDAV settings are also found here.

Setting up and changing Zotero.org credentials. In addition to the process described above (it’s called OAuth), it’s also possible to set your Zotero.org credentials manually. Press the options/menu button on your device to bring up the application menu, and press “Settings”. You can then set your user ID and API key manually. To find those out and set them up, see the “API Keys” section of the preferences for your account at Zotero.org; note that the user ID is a numeric ID,  not your username.

To log out of Zotero, clear the contents of the User ID and API Key fields in the Zandy settings. You can log in again using the main screen button or by manually entering credentials, as described above.

Switching users. Changing the credentials in the Zandy settings can convince Zandy to communicate with Zotero as another user, but it’s likely to cause a bit of a mess. To switch users, the easiest way is to reset the Zandy application data from the Android preferences and start anew.

WebDAV. Zandy’s support for WebDAV is brand-new, and it’s currently limited to opening PDFs. This is largely an artificial limitation, and it should be lifted in the coming week or so. I have also found that Android PDF readers, including Adobe’s reader, sometimes fail to open items without a .pdf extension, as sometimes occurs with attachments fetched from the server. Try another PDF reader if this happens.

Getting Help

If you’re having any trouble with Zandy, or you have any ideas to improve it, I want to hear it!

Just post to the Zandy forum, or contact me via email: zandy@gimranov.com, via Twitter: @ajlyon, or on Google+.

Also, please submit crash reports on any crashes that might occur–the reports provide valuable information on the precise cause of the crash, making it easy to provide a quick fix. See Troubleshooting.

For the more technically inclined, you can also take a look at Zandy’s home on GitHub, where you’ll find the source code, current open issues, and progress on the upcoming release milestones.

Known Issues

  •  Conflict resolution is not implemented. This means that local changes will fail to propagate to the server if the item has changed on the server side. Updated data from the server received on a sync will silently overwrite the local changes. It is advisable to sync frequently to prevent such conflicts, at least until this issue is resolved. (Ticket #18)
  • As described above, changes do not always display immediately in the current collection. This affects the outcome of syncs in particular.
  • Items deleted using the traditional Zotero client are not removed from Zandy when syncing.

License

Just like the Zotero project itself, Zandy is licensed under a Free license, the Affero GNU General Public License, version 3. That means, among other things, that all the source code is freely available, and you can make changes and distribute those changed versions yourself. It is based in small part on the code by Martin Paul Eve to make a Mendeley client for Android. It also uses icons from FamFamFam’s Silk icon set, licensed under the Creative Commons Attribution 2.5 license, and icons from the free icon set provided by Glyphish, licensed under the Creative Commons Attribution 3.0 United States license. Finally, Zandy uses an OAuth implementation from the oauth-signpost project, which is licensed under the Apache license, version 2, and code from the great zxing project for barcode scanner integration, under the same Apache license.

Item metadata for ISBNs is provided by the OCLC xISBN service.

You might be wondering– if Zandy is licensed under a Free license, why does it cost $3.99 on the Android Market and Amazon? Well, that’s because I think it’s worth that much, and that’s enough to make it worthwhile for me to keep working on the project and make it the greatest way to keep up on your research from Android devices. Still, the beauty of it being Free software is that any interested person can take the code and compile it for themselves, or even build a new, even competing project off of it, with the sole caveat that they have to share their modified code.

108 Responses to Zandy User Guide

  1. I’ve been surfing online more than 2 hours today,
    yet I never found any interesting article like yours.

    It’s pretty worth enough for me. In my view, if all web owners and bloggers made good content as you did,
    the web will be a lot more useful than ever before.

    how do you get popular on vine

  2. discours says:

    Un discours de mariage rédigé en bon français, foncez!

  3. Rhea says:

    It’s truly very complex in this busy life to listen news on Television, therefore
    I only use internet for that purpose, and take the most recent news.

  4. Hi there, yes this article is truly fastidious and I have learned lot of things
    from it on the topic of blogging. thanks.

  5. He figured if a QR code worked there, it had great potential as a tattoo.
    Using You – Tube Video Marketing doesn’t guarantee you success,
    but it is a very promising addition to your
    internet marketing campaign. You need not be a social media expert:
    If you’re an expert in any field, it means you take care of the details in your niche and can teach others something they don’t know.

  6. It’s a pity you don’t have a donate button! I’d most certainly
    donate to this brilliant blog! I suppose for now i’ll settle for bookmarking
    and adding your RSS feed to my Google account. I look forward to
    fresh updates and will share this blog with my Facebook
    group. Talk soon!

  7. Thanks for sharing your thoughts on facebook. Regards

  8. WOW just what I was looking for. Came here by searching for judi
    bola online terpercaya

    My web blog judi bola indonesia

  9. Hi there, every time i used to check webpage posts here early in the morning,
    for the reason that i enjoy to gain knowledge of more and more.

  10. If some one wishes expert view regarding running
    a blog after that i recommend him/her to go to see
    this weblog, Keep up the good job.

  11. Hello, this weekend is good in favor of me, as this occasion i am reading this
    wonderful educational piece of writing here at my house.

  12. idm says:

    Overwhelmewd by thhe number of updates and add-ons available for your Firefox web browser.
    Why not download some wonderful ones and save onto your computer or transfer to your mobile phone before they are gone forever.
    Navigator users shuould download the Mailto Watcher add-on utility (available at that allows you to intercept Navigator
    mailtos even when Eudora is not running simultaneously.

  13. Brenda says:

    the standard $9 a typical retailer pays) while having a lower total wage cost;
    and provide each employee with 160 hours of training.
    There are many numerous methods of coating such as organic coating,
    oxide coating and the plating method that many manufacturers use.

    Check out for great tips for choosing a manufacturer of printed circuit
    boards, right now.

  14. ipad zoom says:

    Everything is very open with a precise description of the issues.
    It was truly informative. Your site is very helpful. Thank you
    for sharing!

  15. I got this web site from my buddy who shared with me on the topic of this
    website and at the moment this time I am visiting this web page and reading
    very informative posts at this time.

  16. Ive been meaning you just read this and simply never obtained a chance. Its an issue that Im incredibly enthusiastic about, I just now started reading and Im glad Used to. Youre an awesome blogger, among the finest that Ive seen. This blog certainly has some facts about topic i just wasnt cognizant of. Thanks for bringing this stuff to light.

  17. Duncan Perro says:

    Hi, this site is extremely usefull and i also this way blog a lot.ill share this blog on my own facebook page.

  18. novels says:

    It’s difficult to find well-informed people in this particular topic, however, you seem like you know what you’re talking about!

    Thanks

  19. Get the very best out of your favored Android
    game!

  20. like says:

    An interesting discussion is worth comment. There’s no doubt that that you ought to write more on this subject, it may
    not be a taboo subject but usually folks don’t discuss
    such issues. To the next! Many thanks!!

  21. Math Games says:

    Hi! Would you mind if I share your blog with my facebook group?
    There’s a lot of people that I think would really enjoy your content.
    Please let me know. Many thanks

  22. excellent put up, very informative. I’m wondering why the opposite experts of this sector don’t notice this. You must continue your writing. I am confident, you’ve a huge readers’ base already!

  23. Lucile says:

    Theere are about 1 million members who post their date ideas daily oon this app.
    Con: They are not always good for babies or young children Because Shih Tzus are used to
    being the cemter of attention, they can get jealous of babies oor young children whoo constantly need adultt
    supervision. Decide what you want and then ask around.
    It has a brpad industrial base and is a home to many Forttune 500 companies.
    Sijgles events are structured events that are planned by a service
    which yoou sign upp for and can be anything from a wine and
    cheese tasting to bowling or perhaps even a singles cruise.

    It is the most linguistically and culturally diverse city in America.
    You may have already heard one off our radio spots annd
    wondered what we can do for someone like you. True, maturre citizens find
    this new relationship technology somewhat more complicated, bbut studies show that with thhe right assistance,
    single men annd women are just as likely to use on the internet online relationship services as let’s say 30-year-olds.
    For many people thi iis the second chance for love.
    Whatever the case is, the whole environment will be very relaxed, thus allowing you
    to successfully pick the right potential partneer for yourself to try to form a closer
    bond with.

    If you can’t commit to setting time out daily to combb your dog’s fur, you’ll
    have to make regular appointments with the local dog groomer
    for frequent trims tto keep his coat short annd clean. In 1976, Jackson 5, now rebranded as the Jacksons,
    switched to Epic Records. The more detailed you are, the more successful you
    will bbe at getting messages and having people reply back to your messages.
    If you get a positive answer, then it could be the beginning of a good dating
    relationship. It looks like I have room to improve onn my prep skills.

    Being a resort town nestled along the coast, there are plenty of activities for singles including water sports, tours of the ancient Mayan culture, and plenty of nightlife with a large assortment of restaurants and nighgt clubs!

    Ask around at the hostel to see who is currently offering the best
    money saving ski and snowboard rentals. Some stations may have a chin up bar or
    step for step-ups. The chances that you will get someone oof interest should improve dramatically if you use these ideas for
    finding singles. Whipe rollerblazding in the park, you may not even notice how much you do,
    ass you will be too busy having fun aand enjoying the outside.

    Book a fljght into Denver, Colo., on Southwest Airlines or Frontier Airlines when they are
    on sale for your ski vacation dates. Mind you, the beach is not too commercial, so you
    can only expect basic facilities here. There’s
    lots of more, some very hard. As a society or communiy grows, it needs effective
    administration which can prvide amenities and to carry
    out welfare activities. Many folks live in towns that do not ave many places
    for people too meet.

    You can find people and instantly connect with them using the location-based
    access. Dating services in your local area might also hel you out.
    It was performed during the song ‘Billie Jean’, and became a staple in Jackson’s subsequent live performances.
    With many American dating sites booming today, singles of America
    can find lical singles in their aarea at ease. Youu
    will need to frequent those places in order to meet singles.

    The amazing shopping avenues here also attract a lot of singles (women).
    In this site, a full search is available to all members.
    If we pay tax returns, we’re paying for lean air
    to breath. One can’t quite call iit isolated, but let’s just say that there’s nough room ffor
    everyone here. Fitness Trails Some parks hhave walking
    trails that are actuaally fitness trails.

    Also, if someone has added a photo or updated his/her profile, you will get an instant notification about the same.
    There also is the benefit of looking at meet-up events within your area.
    Of course you can easily find such singles events in your local area just by Googling for them.
    The first time was in 1993, whjen 13-year-old Jordan Chandler accused him of sexual abvuse at
    Michael’s estate, Neverland. Foor a long ski train trip, take the California Zephyr from Chicago
    to Fraser for around $108 one-way.

    All this is simple too ddo and allows you to reach anyone you want.
    The odds are youu will find someone of interest
    in a search onn one of these sites. There are numerous exercises
    and workouts that you can ddo at any local park. Buut do not raise your expdctations too
    much because it is possible to gget a lot oof rejections.

    So, your profile needs to be very interesting and precise as well.
    Why do the owners of these dating sites allow this to occur?
    To fiind a one or two nights of fun, you can go to these places.
    Then the group members meet and socialize, without the extra added pressure
    of trying to “hook up.” Everyone is there for the same reason, and this taes the pressure off, for you can be yourself,
    socialize and have fun in the process. In a way, shape
    or form, most peole always pay…

    Best beaches for family fun Luquillo Beach Activities Swimming Paddling Surfging Luquillo Beach is located at a 30-mile distance east of the capital, San Juan. But finding gratitude at a later age is far from being always easy.
    Even if it is just two of you, it is strill possible to get a workout in playing sports.
    His death was mysterious, with suspicions of homicide, a drug-induced accidental death or suicide, or some
    malice on the part of his personal physician, who prescribed his daily medication. First,
    let us explain what we do.

    It’s an easy way so as to make moiney without the need to put much
    effort around. Jubilee Gardens New Yers Eve: December 31, 2007 Enjoy a diffverent kind of music ith cellist Mary
    Servatius. Without a doubt, you’ve got tto snorkel here, aas the reefs
    are quite spectacular, and definitely worth a look.

    The new “Anonymous Chat” option gives you a chance to chat
    for three minutes with an unknown person and then see each other’s
    photo. The profilles with photographs are able to draw more
    singles than profiles without photos. Whether
    you want to explore something tropical or
    even icy such as Alaska, there is a singles cruise out there
    for you!

    It’s ben a while since I have cauoked anything.
    The Bad world tour, held from September 1988-January 1989,
    broke multiple records of attendance in various countries; the 570,000-strongpeople that watched him in Japan were almost three times the previous record in the country, and
    his seven sellout shows in Wembley Stadium London, totaling a
    crowd of 504,000 people, broke a Guinnss World Record.

    If you want to win the Filipina hsart of a Filipina girl, you should be patient in your
    courtship and bee really thoughtful and romantic. So, next tiime you do not feel
    like exercising, head to your local park and it may just change your attitude about it.With a strong focus on the community, Church of Christ singles were active with outreach prfograms such as rehabilitation and supplementing educational needs for children from high-risk families.

    Feel free to sudf to my homepage … phone chat, Lucile,

  24. Tilly says:

    As mentioned before, patience is key, and you must learn how to evaluate the current condition of
    your tonsil stones as they start degrading. But, if you do
    take in meal, ensure that you wash your mouth and clean it very well.
    In fact, it is counted among the most effective of all tonsil stones remedies.

  25. jasa logo says:

    Nice review. Zandy is new for me. Thanks.

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>