CritList is a browser-based workflow for close listening, note-taking, and session-based annotation of audio material. It is built for people who need to mark moments in a track, compare sessions, tag recurring observations, and export those thoughts in a structured format.
Whether you are working through reviewing reference material, studying sonic detail, or documenting a listening session, CritList turns the act of listening into a clear, organized process. CritList is meant to be a useful companion for thoughtful listening: simple, flexible, and easy to keep close at hand while you work.
CritList is a lightweight Nuxt + Vue application designed to help you:
- designed for local use without a server backend
- load audio files directly in the browser, drag-and-drop audio
- audio EQ controls for critical listening
- create annotations while listening with typed categories
- session-based annotation for multiple hear-throughs
- import and export CSV data for reuse or further analysis
The app is built to support close listening tasks rather than automated analysis. It helps you structure your judgments, questions, and observations while you listen. It is 'typing-first', so the main workflow is accessible via keyboard (no need to switch to your mouse/pad).
- Start CritList on github-pages or build & open the local development URL.
- Drop an audio file into the interface or import a CSV session.
- Play the audio and add annotations by just typing.
- Assign annotation types to help organize your observations.
- Keep multiple listening sessions, export your notes, or combine sessions as needed.
CritList is a tool for organization, documentation, and listening support. It is not a substitute for professional judgment, calibrated monitoring, or formal audio analysis workflows.
This project is provided as-is for personal, research, and creative use. Audio playback and annotation workflows can vary based on the browser, OS, device, and file format. It is your responsibility to verify the accuracy of the data you create, export, or share.
Use it responsibly and keep backups of your work, especially when working with important sessions, archives, or exported annotations.
Contributions are welcome.
If you want to help improve CritList, you can:
- open an issue for bugs or feature requests
- propose design or UX improvements
- improve documentation and onboarding
- submit pull requests with focused changes
Please keep the scope of changes focused, document new behavior clearly, and prefer small, reviewable patches.
To contribute, make sure your commits include a Signed-off-by line like Signed-off-by: Name <email>. You can add this automatically with git commit -s.
By doing so, you certify the following: Developer Certificate of Origin (DCO)
By making a contribution to this project, I certify that:
-
The contribution was created in whole or in part by me and I have the right to submit it under the open source license indicated in the repository.
-
The contribution is based upon previous work that, to the best of my knowledge, is covered under an appropriate open source license and I have the right under that license to submit that work with modifications, whether created in whole or in part by me.
-
The contribution was provided directly to the project by me without any restriction and without expectation of compensation.
-
I understand and agree that this project and the contribution are public and that a record of the contribution (including all personal information I submit with it, such as my name and email address) is maintained indefinitely and may be redistributed consistent with this project’s license.
This project relies on open-source libraries and tools (see package.json), including:
- Nuxt
- Vue
- Tailwind CSS
- Nuxt UI
- Lucide icons
- Simple Icons
- TypeScript
- ESLint
Please review the license terms of those projects before redistribution or commercial use. Their respective licenses apply to the components they provide.
This project is licensed under the MIT License.
See LICENSE for the full text.