Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Electron wrapping to convert the deprecated SaaS web app Lintulista – previously made up of lintulista-client and lintulista-server – into a desktop app.

A screenshot of Lintulista

The gist of Lintulista is that it lets the user create and govern lists of bird sightings, with a visually rewarding presentation. The program is intended for casual use, generally for keeping track of the date on which you first observed a particular species in a given year.

This Electron version of Lintulista has been made with Linux (Ubuntu) in mind. You may need to adapt it to suit other operating environments.

How this repo is organized

The client comprises the app's GUI, while the server mediates access (fetching, adding, and removing observations) to the database of lists. The distributable is what you copy and distribute to whoever you want to give the app – making sure the copy expands symlinks.

Getting started

  1. Install the dependencies: $ yarn run install-all
  2. Refresh the distributable: $ yarn run build-all
  3. View a sample list: $ cd distributable && ./lintulista samplelst && cd -
    • Note: You may need to give the lintulista file executable permission first.

Creating a new list

Have a look at the default sample list, samplelst.json. You can use it as a template for creating new lists.

To create a new list, make a copy of samplelst.json and give the copy a new filename (must be 9 characters from the range [a-z0-9], and with the .json suffix). Reflect the base filename in the key property of the file's JSON content, and set the observations property to an empty string. Leave the other properties as is.

For example, if your new list's key is "abcdefghi", you'd name the file abcdefghi.json, and open it in Lintulista by running $ ./lintulista abcdefghi from the distributable folder.


Lintulista's desktop version.