https://github.com/sumpygump/bell-toll
CLI tool to chime like a clock tower.
https://github.com/sumpygump/bell-toll
Last synced: 3 months ago
JSON representation
CLI tool to chime like a clock tower.
- Host: GitHub
- URL: https://github.com/sumpygump/bell-toll
- Owner: sumpygump
- Created: 2015-03-12T21:32:37.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2023-04-10T03:11:09.000Z (about 2 years ago)
- Last Synced: 2025-01-04T14:17:39.757Z (5 months ago)
- Language: PHP
- Homepage:
- Size: 39.9 MB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Bell Toll
This is a PHP script (command line) that will chime like a clock tower. It has audio files for the 15-minute, 30-minute, 45-minute bell tolls, plus each hour.
## Installation
Install with composer using the following command
```
composer global require sumpygump/belltoll
```
Make sure that `~/.composer/vendor/bin/` is on your `$PATH`
Or symlink it to the the `/usr/local/bin`
```
$ ln -s ~/.composer/vendor/bin/belltoll /usr/local/bin/belltoll
```
## Usage
When you invoke the program it will chime like a bell tower if it is the right time. Simple run `belltoll`. If it is not the right time it will say "It's not time for a bell."
The program relies on `mpg123` to be installed on your machine to actually play the audio files.
You can pass the `-t` or `--time` parameter to force the program to think it is a specific time (for testing). Example: `belltoll -t 1:30`
Use the `-q` or `--quiet` to make the program have no output.
```
Usage: belltoll [options]
Options:
-h [--help] : Display help
-q [--quiet] : No output
-v [--verbose] : Include more verbose output
-t [--time]
### Install as cron task
Since it relies on running at the right time, it is suggested to add it to your crontab. Use the command `$ crontab -e` to edit yours. See the file `crontab.example` for additional details.
```
00,15,30,45 * * * * /usr/local/bin/belltoll >> /dev/null 2>&1
```