fixed repo
parent
8c13993308
commit
7deca290eb
@ -0,0 +1,196 @@
|
||||
# ajw - Asteisk Jukebox Wizard
|
||||
|
||||
Builds a dialplan to make Asterisk function as a jukebox.
|
||||
|
||||
|
||||
## About
|
||||
|
||||
An Asterisk Jukebox is a IVR that mimics the function of a CD jukebox. It
|
||||
currently supports playing single tracks or full albums. Selections are made
|
||||
using a 4 digit code; album number and track number. Basic playback controls
|
||||
are available during album play to skip back, ahead, and repeat track.
|
||||
|
||||
## Requirements
|
||||
|
||||
You will need to have the `func_volume.so` and `func_logic.so` loaded in order
|
||||
to use Asterisk Jukebox. Add these to `modules.conf`
|
||||
|
||||
## How To Use/Setup
|
||||
|
||||
Asterisk Jukebox depends heavily on your files being stored in a specific way;
|
||||
each album is it's own folder, all filenames are track numbers, and the jukebox
|
||||
folder lives in Asterisk's sounds directory.
|
||||
|
||||
```
|
||||
/var/lib/asterisk/sounds/en/(optional-subfolder)/jukeboxroot/album/[(0)1-99].ulaw
|
||||
```
|
||||
|
||||
The 1.0 update to jaw sees it become ajw. The difference is that ajw now makes
|
||||
dialplans that do not include playback logic. This is now a seperate file.
|
||||
|
||||
You no longer tell it how many albums you have, how many folders, or tracks.
|
||||
The script now automatically does all of this; and as a result, albums are added
|
||||
in directory list order. If you want a specific order, prefix your folder names.
|
||||
|
||||
The automatic nature of the script does require your folder/files to already be
|
||||
in place. By default, the script looks in `/var/lib/asterisk/sounds/en` for what
|
||||
you specify to be the jukebox root. If they are one directory deeper in your
|
||||
default sounds; you can specify that in the configuration. Example:
|
||||
|
||||
`/var/lib/asterisk/sounds/en/jukeboxroot/albums` - All jukeboxes live in $asd
|
||||
`/var/lib/asterisk/sounds/en/astjuke/jukeboxroot/albums` - Jukebox roots live
|
||||
under another folder
|
||||
|
||||
You can modify the location of your Asterisk Sounds directory by modifying the
|
||||
`asd=` line at the beginning of the script.
|
||||
|
||||
Once the files are in place and you have read access, run the script and answer
|
||||
the prompts:
|
||||
|
||||
```
|
||||
"Pick a name/identifier for this jukebox:" - name used for dialplan context
|
||||
|
||||
"Enter the folder your jukebox roots live under:" - if your roots live under another
|
||||
folder (because network mount/symlink), enter it here. Blank means no addtional path.
|
||||
|
||||
"Enter the root folder name of your jukebox:" - folder in sounds that contain
|
||||
all your albums
|
||||
|
||||
"Enter the filename of your menu/intro:" - name of file played when answered.
|
||||
lives in juke root.
|
||||
|
||||
"How many times do you want it to play?" - how many times to play the intro
|
||||
before hanging up
|
||||
|
||||
"How many seconds between intro play?" - how many seconds between intro
|
||||
playback
|
||||
|
||||
"Enter the filename of your exit file:" - name of file played before hangup.
|
||||
lives in juke root.
|
||||
|
||||
"Enter A Channel Volume:" - Tell the Volume function to set a volume. Defaults to -3
|
||||
```
|
||||
|
||||
The script now automatically enumerates sub-folders, counts tracks, determines
|
||||
leading zero, and writes the appropiate dialplan. You must prefix your folders
|
||||
with numbers if you want to ensure they are a specific order.
|
||||
|
||||
Make sure the conf file is included in your extensions.conf somehow; the same
|
||||
for tapecart-player.conf.
|
||||
|
||||
```
|
||||
[globals]
|
||||
#include $name-juke.conf
|
||||
```
|
||||
|
||||
Then it's just a matter of directing a call to it's context (usually s,$name-juke).
|
||||
|
||||
## Using The Jukebox
|
||||
|
||||
When you dial the extension you're greeted with your intro file. You then need
|
||||
to enter a 4 digit code comprised of the album and track number:
|
||||
|
||||
```
|
||||
1234
|
||||
| |_________Track number
|
||||
|___________Album number
|
||||
```
|
||||
|
||||
Track number "00" is special and when entered, will play the entire album back
|
||||
from the beginning. In album playback, the following controls affect playback:
|
||||
|
||||
- 1 - skips back a track
|
||||
- 2 - repeats the current track
|
||||
- 3 - skips ahead a track
|
||||
|
||||
At the end of the album, or at any time during playback; pressing 0 returns to
|
||||
the main menu.
|
||||
|
||||
Single track playback returns to the main menu at the end of the track, or by
|
||||
pressing 0.
|
||||
|
||||
# History
|
||||
|
||||
```
|
||||
21-SEP-2022 - Add subfolder option - track sanitization for cart-player
|
||||
14-AUG-2022 - Fixed missed (goodbye) label in setup context.
|
||||
12-AUG-2022 - Doesn't write delay if you set Delay to 0.
|
||||
11-MAY-2022 - Fatal error in accidently escaped character fixed.
|
||||
07-MAY-2022 - Initial Commit
|
||||
```
|
||||
|
||||
# Explanation of Generated Dialplan
|
||||
|
||||
The dialplan has undergone some extensive changes since last update. The
|
||||
use of While has been eliminated as it caused some problems. The way some
|
||||
things are done have been drastically changed (hopefully for the better). Some
|
||||
of this was necessitated by the wizard; some of it was in spite of the wizard.
|
||||
|
||||
```
|
||||
[examplejuke-main]
|
||||
exten = s,1,Answer()
|
||||
same = n,Set(VOLUME(TX)=-3)
|
||||
same = n,Set(c=examplejuke-main)
|
||||
same = n(loop),Background(foobar/menu)
|
||||
same = n,WaitExten(5)
|
||||
same = n,Set(m=$[${m} + 1])
|
||||
same = n,GoToIf($["${m}" < "5"]?loop)
|
||||
same = n(goodbye),Background(foobar/bye)
|
||||
same = n,Hangup()
|
||||
|
||||
```
|
||||
|
||||
After being answered, we set not just the channel volume but the context name.
|
||||
Most of this is just looping the intro.
|
||||
|
||||
```
|
||||
exten = _00XX,1,Set(aa=foobar/00album)
|
||||
same = n,GoToIf($["${EXTEN:-2}" = "00"]?8track-player,*11,1)
|
||||
same = n,GoToIf($["${EXTEN:-2}" > "19"]?9999)
|
||||
same = n,GoTo(cart-player,*${EXTEN:-2},1)
|
||||
same = 9999,Playback(option-is-invalid)
|
||||
same = n,GoTo(examplejuke-main,s,1)
|
||||
|
||||
exten = _01XX,1,Set(aa=foobar/01album)
|
||||
same = n,GoToIf($["${EXTEN:-2}" = "00"]?8track-player,*15,1)
|
||||
same = n,GoToIf($["${EXTEN:-2}" > "19"]?9999)
|
||||
same = n,GoTo(cart-player,*${EXTEN:-2},1)
|
||||
same = 9999,Playback(option-is-invalid)
|
||||
same = n,GoTo(examplejuke-main,s,1)
|
||||
|
||||
exten = _02XX,1,Set(aa=foobar/02album)
|
||||
same = n,GoToIf($["${EXTEN:-2}" = "00"]?8track-player,#12,1)
|
||||
same = n,GoToIf($["${EXTEN:-2}" > "19"]?9999)
|
||||
same = n,GoToIf($["${EXTEN:-2}" < "10"]?cart-player,#${EXTEN:-1},1) ; these files don't have a leading zero
|
||||
same = n,GoTo(cart-player,*${EXTEN:-2},1)
|
||||
same = 9999,Playback(option-is-invalid)
|
||||
same = n,GoTo(examplejuke-main,s,1)
|
||||
```
|
||||
We no longer write the last two of the extension to a variable, we just call it
|
||||
directly from now on. We also now use that as the extension we dial in the
|
||||
single playback routine. We call either an extension starting with # or *
|
||||
depending on the leading zero situation. AJW handles writing all of this.
|
||||
|
||||
A full explanation of how the jukebox works, including explanation of
|
||||
tapecart-player.conf is at the repository:
|
||||
https://git.pickmy.org/dewdude/Asterisk_Jukebox/src/master/HOWITWORKS.MD
|
||||
|
||||
# License
|
||||
|
||||
ajw - Asterisk Jukebox Wizard
|
||||
Copyright (C) 2022 Jay Moore - nq4tango@gmail.com
|
||||
|
||||
This program is free software: you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation, either version 3 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||
|
||||
|
||||
Loading…
Reference in New Issue