explaingit

jhjonesmo/chordpresenter

Analysis updated 2026-05-18

1PythonAudience · generalComplexity · 3/5Setup · hard

TLDR

A macOS desktop app that fetches chord charts from worship music websites and converts them into ProPresenter stage-monitor files, with key transposition built in.

Mindmap

mindmap
  root((ChordPresenter))
    Input methods
      Drag Obsidian Clipper file
      Paste song URL
    Features
      Key transposition
      Slide preview
      Chords and lyrics
    Supported sites
      Ultimate Guitar
      EssentialWorship
      WorshipTogether
    Tech stack
      Tauri app
      Python pipeline
      Rust backend
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Convert a chord chart from Ultimate Guitar or EssentialWorship into a ProPresenter .pro file ready for Sunday worship.

USE CASE 2

Transpose a song to a different key and generate the stage monitor file in one step.

USE CASE 3

Drag an Obsidian Clipper export of a song page into the app to preview and produce a formatted ProPresenter slide deck.

USE CASE 4

Fetch lyrics from a supported URL, preview the slide layout, and export the .pro file to a chosen folder.

What is it built with?

PythonRustTauriNode.jsprotobuf

How does it compare?

jhjonesmo/chordpresentera-bissell/unleash-liteabhiinnovates/whatsapp-hr-assistant
Stars111
LanguagePythonPythonPython
Setup difficultyhardhardhard
Complexity3/54/53/5
Audiencegeneralresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Building from source requires Rust, Node with pnpm, Python 3, and Xcode CLI tools, macOS only, no pre-built installer is linked in the README.

Free to use, no formal open-source license is stated in the README.

In plain English

ChordPresenter is a macOS desktop app designed for worship musicians and church tech teams who need to get online chord charts into ProPresenter for stage monitor display. ProPresenter is software commonly used in churches to show song lyrics and chords on screens for band members and vocalists, but importing chord charts from websites requires manual work. This app removes those steps. There are two ways to bring a song in. The first uses a browser extension called Obsidian Clipper, which converts the web page you are viewing into a Markdown file. You drag that file into ChordPresenter and get a preview before the app produces a ProPresenter-formatted file. The second method lets you paste a URL directly into the app, it fetches the page, parses the chords and lyrics, shows a preview, and writes the output file to a folder you choose. The app supports a range of popular chord and lyric sites, including Ultimate Guitar, EssentialWorship, WorshipTogether, and several others. For sites that publish only lyrics without chords, it imports lyrics alone. It can also transpose keys: it detects the original key from the chord chart and lets you shift to any target key before export. ChordPresenter is built with Tauri, a framework that wraps a web frontend with a Rust backend into a native desktop app. The chord-processing pipeline is written in Python and uses protobuf to produce the binary .pro files that ProPresenter reads. Building from source requires a Rust toolchain, Node with pnpm, Python 3, and Xcode command-line tools, so it is macOS-only for now. The project is a free side project, and the author describes it as a work in progress. Windows support is planned but not yet available, and some slides may need minor layout adjustments after import depending on lyric line length. The author welcomes bug reports and has built logging into the app to help diagnose issues.

Copy-paste prompts

Prompt 1
I have a URL from WorshipTogether.com for a worship song. Walk me through using ChordPresenter to convert it into a ProPresenter .pro file step by step.
Prompt 2
Using ChordPresenter, how do I transpose a chord chart from the key of G to D before exporting to ProPresenter?
Prompt 3
Explain what the md_to_pro.py script does and how the Python pipeline in ChordPresenter converts Markdown chord charts to ProPresenter binary files.
Prompt 4
How do I build ChordPresenter from source on macOS? List every prerequisite and the exact terminal commands to run.

Frequently asked questions

What is chordpresenter?

A macOS desktop app that fetches chord charts from worship music websites and converts them into ProPresenter stage-monitor files, with key transposition built in.

What language is chordpresenter written in?

Mainly Python. The stack also includes Python, Rust, Tauri.

What license does chordpresenter use?

Free to use, no formal open-source license is stated in the README.

How hard is chordpresenter to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is chordpresenter for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub jhjonesmo on gitmyhub

Verify against the repo before relying on details.