{"id":15429106,"url":"https://github.com/richardlitt/open-ebird-checklists","last_synced_at":"2026-05-07T20:02:39.609Z","repository":{"id":195917757,"uuid":"693953559","full_name":"RichardLitt/open-ebird-checklists","owner":"RichardLitt","description":"A script to automatically open all checklists from an eBird region.","archived":false,"fork":false,"pushed_at":"2023-09-22T02:22:20.000Z","size":8,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-25T12:09:54.117Z","etag":null,"topics":["birding","ebird"],"latest_commit_sha":null,"homepage":"https://birdinginvermont.com","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RichardLitt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-09-20T03:24:33.000Z","updated_at":"2023-09-23T21:39:05.000Z","dependencies_parsed_at":"2023-10-14T17:16:25.069Z","dependency_job_id":"79406b51-bb92-40f7-9f28-41d9a1fb982a","html_url":"https://github.com/RichardLitt/open-ebird-checklists","commit_stats":{"total_commits":7,"total_committers":1,"mean_commits":7.0,"dds":0.0,"last_synced_commit":"15af40bfc0a51ece520ec8589650713d045d566b"},"previous_names":["richardlitt/open-ebird-checklists"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RichardLitt%2Fopen-ebird-checklists","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RichardLitt%2Fopen-ebird-checklists/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RichardLitt%2Fopen-ebird-checklists/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RichardLitt%2Fopen-ebird-checklists/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RichardLitt","download_url":"https://codeload.github.com/RichardLitt/open-ebird-checklists/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244609376,"owners_count":20480781,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["birding","ebird"],"created_at":"2024-10-01T18:08:52.117Z","updated_at":"2026-05-07T20:02:34.572Z","avatar_url":"https://github.com/RichardLitt.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# eBird Checklists\n\nThis script automates the process of opening eBird checklists for a specified region and date. It is useful for eBird reviewers and enthusiasts who want to easily access and review checklists in their area.\n\n## Table of Contents\n- [Why this repo?](#why-this-repo)\n- [Prerequisites](#prerequisites)\n- [Usage](#usage)\n  - [Examples](#examples)\n- [Install](#install)\n- [Troubleshooting](#troubleshooting)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Why this repo?\n\nI consistently wanted to see what eBird checklists are happening in my area, easily. I didn't want to have to keep looking for them manually on the website, which only shows a few recent checklists, and I wanted to be able to see them for specific dates. As well, eBird flags certain records, but not all - so in my work as a reviewer, it makes sense to take a look at new checklists coming in to see if there are any easily-spottable errors I can contact users about. This tool provides that functionality, by opening a list of checklists for a given date from a given region. \n\n## Prerequisites\n\nBefore using this script, ensure you have the following:\n\n- [eBird API Token](https://ebird.org/api/keygen)\n- [curl](https://curl.se/) and Bash v3 installed on your system\n\n\n## Usage\n\n    $ ./openEbirdChecklists.sh \u003cregion\u003e \u003cdate in mm/dd/yyyy format|today|yesterday\u003e\n\nThis script will accept the names of Vermont counties, or the eBird\nregion codes, like 'US-NC' from 'https://ebird.org/region/US-NC'.\n\nIf no date is provided, it will only show the ten most recent\nchecklists, or however many eBird provides for recent checklists.\n\n### Examples\n\n    $ ./openEbirdChecklists.sh Addison 09/16/2023\n    $ ./openEbirdChecklists.sh Washington yesterday\n    $ ./openEbirdChecklists.sh US-VT-001 09/16/2023\n    $ ./openEbirdChecklists.sh Orange\n\n## Install\n\n1. Replace the API token in line three with your own token. You can obtain one by registering at [eBird API Keygen](https://ebird.org/api/keygen).\n\nAlternatively, you can set an environment variable for `$EBIRD_API_TOKEN`, eith in your PATH somewhere or temporarily like this:\n\n   ```bash\n   $ export EBIRD_API_TOKEN='your_api_token_here'\n   ```\n\n2. Make it executable. Change directory in your terminal to where the script was downloaded, and run:\n\n    ```bash\n    $ chmod a+x ebirdChecklists.sh\n    ```\n\n3. Run it using the above examples.\n\n    ```bash\n    $ EBIRD_API_TOKEN='example' ./openEbirdChecklists.sh \u003cregion\u003e \u003cdate\u003e\n    ```\n\n## Troubleshooting\n\nIf you encounter any issues while running the script, consider the following:\n\n- **Invalid API Token**: Double-check that you have replaced the API token with a valid one from [eBird API Keygen](https://ebird.org/api/keygen).\n\n- **Missing Dependencies**: Ensure that you have installed `curl` and set it up correctly.\n\n- **Permission Denied**: If you get a \"Permission denied\" error when running the script, make sure you have executed `chmod a+x openEbirdChecklists.sh` as mentioned in the installation instructions.\n\n\n## Contributing\n\nContributions to this project are welcome! If you'd like to contribute, please follow these guidelines:\n\n- **Bug Reports**: If you encounter a bug or unexpected behavior, open an issue on the GitHub repository.\n\n- **Feature Requests**: Feel free to suggest new features or improvements by creating an issue.\n\n- **Pull Requests**: If you have code changes or enhancements to offer, submit a pull request. Please make sure your code follows the project's coding standards.\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE). See the [LICENSE](LICENSE) file for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frichardlitt%2Fopen-ebird-checklists","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frichardlitt%2Fopen-ebird-checklists","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frichardlitt%2Fopen-ebird-checklists/lists"}