Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/holgerjh/halloween-phone
Hacky program that uses baresip, ffmpeg and pulse to dial a contact and inject a wav file into the call. Used to play spooky sounds during a party.
https://github.com/holgerjh/halloween-phone
Last synced: about 1 month ago
JSON representation
Hacky program that uses baresip, ffmpeg and pulse to dial a contact and inject a wav file into the call. Used to play spooky sounds during a party.
- Host: GitHub
- URL: https://github.com/holgerjh/halloween-phone
- Owner: holgerjh
- License: apache-2.0
- Created: 2022-10-28T12:41:42.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2022-10-29T17:55:12.000Z (about 2 years ago)
- Last Synced: 2024-06-21T20:04:25.573Z (6 months ago)
- Language: Go
- Size: 2.98 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📞 Halloween-Phone 📞
Hacky program that uses baresip, ffmpeg and pulse to dial a contact and inject a wav file into the call. Used to play spooky sounds during a party 😱.
Work in progress. No tests, no dockerfile. Hacked together with very limited
time.
## Warning
**WARNING: Make sure to double-check the contact that is dialed if you run
`/dialcontact` so you do not perform calls that may cost you money. If
possible, block outgoing calls in your SIP provider. I do not take any
responsibility for costs that occure using this program. Use at your own risk!**
## How does it work
```
┌─────────────┐
┌─────────┤ wavs │
│ └─────────────┴─────┐
│ │<>
│<> ┌──────────▼────────────┐
│ │ │
│ ┌───┤ halloween-phone │
│ │ │ ├───────────┐
│ <> └───────────────────────┘ │<>
│ ┌───▼───────┐ ┌───────────────────┐ ┌────▼──────┐
└─────────►│ ffmpeg ├──► virtual pulse mic ├───► baresip │
└───────────┘ └───────────────────┘ └───────────┘
```
Halloween-phone takes a folder with wav files and registers a virtual pulse audio microphone. It then schedules the files to be played. When the time comes, it runs baresip and calls the default contact. When someone picks up, ffmpeg is utilized to stream the wav file into the microphone. As soon as the callee hangs up, the programs are terminated again. Halloween-phone loops forever until CTRL+C is pressed. The timeout between calls, as well as other things, can be configured to match your desired use-case (which is, of course, running a spooky party 🎉🎉🎉).
## Setup
### Hardware
* A physical telephone to call. I used a really old one one with pulse dialing. This had the bennefit that none of my guests could make any outgoing calls. The telephone needs to be callable. I had to solder a connector to connect the phone to my router. For german phones you should connect white and brown wires (ignore the green one if it exists), should be the same for international phones. For american phones, it should be red and green. Please double-check this against other sources before make any connections.
### Programs
* Compile with `go build`
* Install `ffmpeg`, `baresip` and `pulseaudio`
## Configuration
* Setup pulseaudio
* Must be working. Use e.g. `pavucontrol` to check on pulse.
* Setup baresip
* It must register as a SIP client on startup
* It must have a default contact it calls when `/dialcontact` is entered
* It must use `pulse` as values for both `audio_player` and `audio_source`
* `ausrc_srate` and `ausrc_format` must match settings for ffmpeg and virtual pulse mic. I successfully used a rate of `8000` and format `s16`.
* Setup halloween-phone
* Place configuration in `~/.config/halloween-phone.cfg`
**For example configuration, see folder [example-config](https://github.com/holgerjh/halloween-phone/tree/main/example-config).**
### Prepare Tracks
* Put `wav` files into the folder defined in the configuration file. Make sure the encoding matches the settings in the configuration (rate, format etc). Audacity is a cool tool that can be used for this.