Skip to content
Software (with Kivy GUI) for semi-automated segmentation and analysis of birdsongs or other acoustic signals.
Python Other
  1. Python 99.8%
  2. Other 0.2%
Branch: master
Clone or download
This branch is even with asearfos:master.

Latest commit

asearfos updated version
corrections to install from source
Latest commit a74f3f1 Jan 22, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
build Update spec file to pull dlls based on .so name. Renamed file to run Dec 3, 2019
chipper Updated landing page. Changed term "modulation" to "range". Jan 20, 2020
docs updated version Jan 22, 2020
synthetic_songs Reorganized scripts used for synthetic song generation and analysis. … Dec 4, 2019
LICENSE Create LICENSE Jul 3, 2019
README.md fix typo Jan 22, 2020
requirements.txt Trimming requirements file. Jul 9, 2019

README.md

Chipper

Chipper is a software (with a GUI) for semi-automated segmentation and analysis of birdsongs or other acoustic signals.

Documentation

Full documentation is available as a Chipper Manual on GitHub. For associated publication see Searfoss, Pino, Creanza 2020 (Under Review) or preprint at bioRxiv.

Download Chipper

  1. Download the correct version of Chipper for your operating system.

  2. Unzip the folder, extracting all files.

  3. Run the application file.

    • Windows

      • Navigate into the start_chipper folder and double click the Application file (.exe) named start_chipper, which may have a bird as an icon.
      • The first time you try to open the file, you may receive the message "Windows Defender SmartScreen prevented an unrecognized app from starting. Running this app might put your PC at risk." Click "More info" and then select "Run anyway".
      • You will now see a terminal window open.
    • Mac

      • Navigate into the start_chipper folder and double click the Unix executable file named start_chipper.
      • The first time you try to open the file, you may receive the message "start_chipper can't be opened because it is from an unidentified developer". If so, right click on the file and select "Open". Click "Open" again on the popup to confirm.
      • You will now see a terminal window open.
      • If you continue to receive pop-ups indicating the developer cannot be identified or verified, you will need to update which apps you allow. (Common for macOS Catalina.)
        • Open System Preferences > Security & Privacy > General. Under “Allow apps downloaded from:” select “Anywhere”. If this is not an option, continue to the next step.
        • Open Terminal and enter $ sudo spctl --master-disable
        • Reopen System Preferences. The third option "Anywhere" should now be available. Click the lock, type your password, and select this option.
        • Try again to click and run the executable file named start_chipper.
        • Once you successfully run Chipper, you can change the “Allow apps downloaded from” setting back to the default to restore security.
    • Linux

      • Open the terminal and type $ /path/to/start_chipper/start_chipper", replacing "/path/to" with the full file location.
      • Hit enter.
  4. The Chipper landing page will soon open. Note, this can take some time to load the first time. If it does not open, close the terminal and try opening the start_chipper file again. For best performance, we recommend using Chipper in full-screen mode, especially if you are working on a low resolution display. You are ready to go!

Install from source

This is recommended for developers.

  1. Install Anaconda

    Our recommended approach is to use Anaconda, which is a distribution of Python containing most of the numeric and scientific software needed to get started. If you are a Mac or Linux user, have used Python before and are comfortable using pip to install software, you may want to skip this step and use your existing Python installation.

  2. Next, download our code, including the requirements.txt file. From within a terminal or command prompt window, create a conda environment.

    $ conda create -n chipper_env python=3.7
    
    • For Mac and Linux, install packages with conda:

      $ conda install -r requirements.txt
      $ conda install pypiwin32 kivy.deps.sdl2 kivy.deps.glew kivy.deps.gstreamer kivy.deps.glew_dev kivy.deps.sdl2_dev kivy.deps.gstreamer_dev
      
    • For Windows users, you may need to use pip:

      $ pip install -r requirements.txt
      $ pip install pypiwin32 kivy.deps.sdl2 kivy.deps.glew kivy.deps.gstreamer kivy.deps.glew_dev kivy.deps.sdl2_dev kivy.deps.gstreamer_dev
      
  3. Install kivy packages

    $ garden install --kivy graph
    $ garden install --kivy filebrowser
    $ garden install --kivy matplotlib
    $ garden install --kivy progressspinner
    
You can’t perform that action at this time.