Skip to content
Jeanne is meant to be a powerful Music bot for Mumble, with voice recognition
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
data Example voice config with example voice samples Aug 6, 2017
lib Fix voice extension crashing with empty map file Aug 6, 2017
.codeclimate.yml Fix for seeking command not doing anything on lower quality video May 15, 2017
.editorconfig Add ESLint config and proper log May 14, 2017
.eslintignore Fix for seeking command not doing anything on lower quality video May 15, 2017
.eslintrc.json Removing unused dependency Jun 16, 2017
.gitignore Voice sample / pun support May 30, 2017
.snyk fix: .snyk & package.json to reduce vulnerabilities (#8) Jun 25, 2018
LICENSE Initial Commit Apr 24, 2017 Update README with link to wiki Jul 30, 2017
jeanne Initial Commit Apr 24, 2017
package-lock.json [Snyk Update] New fixes for 4 vulnerable dependency paths (#5) Mar 19, 2018
package.json fix: .snyk & package.json to reduce vulnerabilities (#8) Jun 25, 2018

Who is Jeanne ?

Code Climate contributions welcome

Jeanne is meant to be a powerful Music bot for Mumble, with voice recognition. She can stream youtube video and (web)radio, with features like on-the-fly playlist and auto-playing.

Table of Contents

How does she work ?

Jeanne uses Google Speech API (old version) to get transcripts of your whispers. She then matches them against a set of commands. You can also type those commands to her.

Currently, the only language supported is french, but it should be simple to add new ones with your pull requests !

Jeanne is based on Stumble. She uses:

How to use her ?


Please see the wiki commands page.


The list of radio currently available is:

Radio Kawa, Bim Team Radio, Nova, franceinfo, France Inter, France Musique, Skyrock, Oui FM, France Musique Classique easy, France Musique Classique plus, France Musique Concerts de Radio France, France Musique Musiques du monde - Ocora, France Musique La Jazz, France Musique La Contemporaine, France Culture, FIP (national), FIP à Nantes, FIP à Bordeaux, FIP à Strasbourg, FIP autour du rock, FIP autour du jazz, FIP autour du groove, FIP autour du monde, Tout nouveau, tout FIP, Mouv’, Mouv’ Xtra, France Bleu Alsace, France Bleu Armorique, France Bleu Auxerre, France Bleu Azur, France Bleu Béarn , France Bleu Belfort-Montbéliard, France Bleu Berry, France Bleu Besançon, France Bleu Bourgogne, France Bleu Breizh Izel, France Bleu Champagne-Ardenne, France Bleu Cotentin, France Bleu Creuse, France Bleu Drôme Ardèche, France Bleu Elsass, France Bleu Gard Lozère, France Bleu Gascogne, France Bleu Gironde, France Bleu Hérault, France Bleu Isère, France Bleu La Rochelle, France Bleu Limousin, France Bleu Loire Océan, France Bleu Lorraine Nord, France Bleu Maine, France Bleu Mayenne, France Bleu Nord, France Bleu Normandie (Calvados – Orne), France Bleu Normandie (Seine-Maritime – Eure), France Bleu Orléans, France Bleu Paris, France Bleu Pays d’Auvergne, France Bleu Pays de Savoie, France Bleu Pays Basque, France Bleu Perigord, France Bleu Picardie, France Bleu Poitou, France Bleu Provence, France Bleu RCFM Frequenza Mora, France Bleu Roussillon, France Bleu Saint-Étienne-Loire, France Bleu Sud Lorraine, France Bleu Toulouse, France Bleu Touraine, France Bleu Vaucluse, RFI Monde, RFI Afrique, BFM, Canal FM, Canal Sud, Chérie FM, Europe 1, Evasion FM, Flor FM, Fréquence3, Gold Fréquence3, Urban Fréquence3, Fréquence Plus, Gold FM, Jazz Radio, Kiss FM Dance, Magic Radio, Nostalgie, NRJ, Oceane FM, 100% Radio, Radio 6, Radio Bonne Nouvelle, Radio Bruaysis, Radio Campus Rennes, Radio Emotion, Radio Galaxie, Radio Menergy, Radio Scoop, Radio Scoop 91.3, Radio Scoop 98.8, Radio Scoop 89.2, Radio Scoop 100% Années 80, Radio Scoop 100% Music Pod, Radio Scoop 100% Powerdance, Radio Scoop 100% Salon du Mariage, RFM, RFM Collector, RFM Night Fever, Rire et Chansons, RMC, Toulouse FM, Virgin Radio, Virgin Radio Classics, Virgin Radio New, Virgin Radio Electro Shock, Virgin Radio Hit, Virgin Radio Rock, Vitamine

You can easily add radios by editing the file data/radios.json


Since Jeanne uses fluent-ffmpeg, you have to install ffmpeg. If you have some troubles please follow the instructions at

Start by cloning the repo and installing the package:

git clone
cd node-jeanne
npm i

Then, you need API-keys for youtube and google-speech ( They should be placed in keys/api-keys.json. The file should look like this:

    "youtube": "your-key-here",
    "google-speech": "your-key-here"

After that you need to edit your config file (data/config.json). You should only modify the server part and the default channel (extensions>info>movement>home)

You can test that she runs and connects to your server by running node index.js

Running at startup

On debian-base linux:

For that you need to install forever:

npm i -g forever

Then simply edit the file jeanne and replace the paths with yours:

pidFile="<jeanne path>/"
logFile="<jeanne path>/jeanne.log"

nodeApp="<jeanne path>/index.js"


Move the script to /etc/init.d/jeanne and run

update-rc.d jeanne defaults

To uninstall run

update-rc.d -f jeanne remove


  • Wiki
  • Add languages
You can’t perform that action at this time.