audio-cast 0.0.16
A system to cast audio input to chromecast devices.
Requires Python: >=3.6

# Application to cast streams to chromecast

*Note: Designed to work with Rpi 4. Any installation process works for the Rpi4.*

## Production installation

### Using pip (Windows/Linux/osX)

This requires to have `python3` installed and `pip` installed. Optionally also `venv`.

1. (Optional) Create virtual environment to avoid dependency issues.
   - Example using venv:
     - Create: `python3 -m venv <DIR>`
     - Start: linux - `source <DIR>/bin/activate` - windows - `<DIR>/Scripts/activate`
     - Stop: `deactivate`
     - To clear delete the directory and create again `rm -r <DIR>`
2. Install package from pip:
   - Linux/osX: `python3 -m pip install audio_cast`
   - Windows: `py -m pip install audio_cast`
3. Install required applications:
   1. Install vlc:
      - Linux/osX has 2 alternatives:
         - Install required libraries:
            - `sudo apt install vlc-bin`
            - `sudo apt install vlc-plugin-base`
         - Install VLC `sudo apt install vlc`
      - Windows: Install vlc from their website.
   2. (Only Linux/osX) Install `libportaudio2`: `sudo apt install libportaudio2`
4. Install a WSGI server.
   - Waitress: `pip install waitress`
5. Run WSGI server.
   - Example: `waitress-serve --call --host=localhost --port=5000 'audio_cast:create_app'`

### Using apt (Linux)

## Dev Usage

- When using VS Code, just run the debugger.
- Optional: Use a virtual environment.
- When starting from termimal.
  1. Set environment variable for `FLASK_APP` to `audio_cast`.
     - Linux/osX: `export set FLASK_APP=audio_cast`
     - Windows cmd: `set FLASK_APP=audio_cast`
     - Windows powershell: `$Env:FLASK_APP = "audio_cast"`
  2. Launch the server with `python -m flask run`.

### Cheatsheet

- To upload to pypi:
  - Build: `py -m build`
  - Deploy: `py -m twine upload dist/*`
- To run locally:
  - Set environment variable `FLASK_APP=audio_cast`
- To run after installation from package:
  - Install waitress `python3 -m pip install waitress`
  - Run waitress `waitress-serve --call --host=localhost --port=5000 'audio_cast:create_app'`
- Virtual environment:
  - Create: `python3 -m venv <DIR>`
  - Start: linux - `source <DIR>/bin/activate` - windows - `<DIR>/Scripts/activate`
  - Stop: `deactivate`
  - To clear delete the directory and create again `rm -r <DIR>`
- Install packages from `requirements.txt` `pip install -r requirements.txt`.

## Rpi steps

1. Install pip using apt `sudo apt install python3-pip`
2. Install venv using apt `sudo apt install python3-venv`.
3. Create virtual environment and activate it.
4. Install waitress.
5. Run waitress, run it without host so it is exposed.
6. Install vlc `sudo apt install vlc`
   - Hopefully this can be changed to either incorporating the libvlc libraries or installing a part of vlc. Right now it's around 1 gb, which seems too much for the use needed.
   - Or install vlc-bin and vlc-plugin-base. `sudo apt install vlc-bin` and `sudo apt install vlc-plugin-base`. It's smaller but still big. Aroung 700MB.
   - Still there might be a better way.
7. Install PortAudio using apt `sudo apt install libportaudio2`.