# Free Parrot

Free Parrot is a web app for easily recording throwaway audio clips.

It was originally intended for pronunciation practice but may find other uses.


## Getting Started

The easiest way to use Free Parrot is to open the provided standalone HTML file(s).

- Free Parrot: `standalone/free-parrot.standalone.html`
- Help for Free Parrot: `standalone/free-parrot-help.standalone.html`

(Preferences set on the standalone Help page will carry over to standalone Free Parrot if you use Safari or Chrome, but in Firefox they will not.)

If you want to make changes to standalone Free Parrot, you can

- change the standalone HTML files in `standalone` directly, or
- change the source files in `src`, then generate new standalone HTML files using the provided tool at `standalone/create-standalone.html` (open it in your browser).

### Using a Local Web Server

You can access Free Parrot on localhost by serving the `src` directory using a local web server.

For example, if you have Python (3) installed, from the `free-parrot` directory, run:

```
python3 -m http.server 8000 -d src
```

Then open [Free Parrot on localhost](http://localhost:8000).

#### Automatic Reloader

If you want your changes to the `src` files to be automatically reflected in Free Parrot served over localhost, you can do the following:

1. Run the `reloader.ts` server script (provided; requires `deno`)
2. Run `ls * | entr -s 'curl -s localhost:8008 > /dev/null'` from the `src` folder (requires `entr` and `curl`)

`index.html` and `help.html` already have a `<script>` in the `<head>` that connects to the `reloader` server on port 8008 and reloads the page when a file is changed. It looks like this:

```html
<script>new WebSocket("ws://localhost:8008").onmessage = () => location.reload();</script>
```

---

If you want to learn how to use Free Parrot, see the help page (`help.html`).


## License

Copyright © 2026 Em Zakharov

Free Parrot is Free Software:

- Code is licensed under the GNU GPLv3 or any later version. [[GNU GPLv3](https://www.gnu.org/licenses/gpl-3.0.html)]
- Images, audio, and text are licensed under CC BY-SA 4.0. [[CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)]
