planning-center-to-local-pl…/.env.example


# Please go to https://api.planningcenteronline.com/oauth/applications
# Create new Personal Access Token
# Paste them below
CLIENT = ""
SECRET = ""
# USER_ID can be found via API or after logging into PCO, clicking your initials in top right of screen, and clicking "My Profile".
# The URL will be: https://services.planningcenteronline.com/people/XX{user_id}/edit
# Just grab the numbers, not the two letters before it.
USER_ID = ""
# DIR is the final resting place of your music files from PCO. Should be accessible on the same device/VM as this flask app is running.
# TODO: Add option for transferring files between services via ssh
DIR = "/path/to/your/music"
# Options include DEBUG, INFO
# DEBUG will print the entire payloads to log files.
LOGLEVEL = "INFO"
# Download All Files or only the ones that match Track Names? default=false
# WARN: For the time being, keep ALLFILESBOOK as True as I am unsure what will happen with False.
# While the goal was to give end users the option to only download specified tracks, there doesn't seem to be consistency in the file names to make this possible. My church has stuff like "PTTL" for Praise to the Lord (full band) and "IKAN_EG1_rehearsal" for I Know a Name - Guitar 1 rehearsal track. Plus, we don't use attachment_types, which is where a PCO admin might administer instruments or otherwise. I can't see right now how I'd scale this across the many churches implementing PCO.

# TODO: Add option for specific instrument files to download.
ALLFILESBOOL = "True"
# Enter the artist name you want for the id3v2 tag so that the Subsonic API picks it up.
ARTIST = ""
README has started! Added some instructions and limitations to be aware of with the app. Add more logging messages. Added some testing functions to test the various webhook and user states that may be configured. Added an environmental variable for downloading some or all songs. Unfortunately, due to the various ways certain songs may be named (see comments and README), this is proving harder than usual. Added a function for applying the metadata to the final downloaded songs so that it can be picked up by Navidrome/Subsonic API. Split up a few functions into smaller functions. Tried adding some better logging and messaging around songs that are marked as non-downloadable and other messages. 2025-06-18 21:17:32 -04:00
First commit for this small Flask app. Logic added for following states: my service type future with attachments, my service type future no attachments, my service type past, not my service. Need to test with real attachments and add functions for adding the Id3 tags. Will also need to bundle this in a docker container for ease of deployment. 2025-06-11 16:46:35 -04:00			`# Please go to https://api.planningcenteronline.com/oauth/applications`
			`# Create new Personal Access Token`
			`# Paste them below`
			`CLIENT = ""`
			`SECRET = ""`
			`# USER_ID can be found via API or after logging into PCO, clicking your initials in top right of screen, and clicking "My Profile".`
			`# The URL will be: https://services.planningcenteronline.com/people/XX{user_id}/edit`
			`# Just grab the numbers, not the two letters before it.`
			`USER_ID = ""`
			`# DIR is the final resting place of your music files from PCO. Should be accessible on the same device/VM as this flask app is running.`
README has started! Added some instructions and limitations to be aware of with the app. Add more logging messages. Added some testing functions to test the various webhook and user states that may be configured. Added an environmental variable for downloading some or all songs. Unfortunately, due to the various ways certain songs may be named (see comments and README), this is proving harder than usual. Added a function for applying the metadata to the final downloaded songs so that it can be picked up by Navidrome/Subsonic API. Split up a few functions into smaller functions. Tried adding some better logging and messaging around songs that are marked as non-downloadable and other messages. 2025-06-18 21:17:32 -04:00			`# TODO: Add option for transferring files between services via ssh`
			`DIR = "/path/to/your/music"`
			`# Options include DEBUG, INFO`
			`# DEBUG will print the entire payloads to log files.`
First commit for this small Flask app. Logic added for following states: my service type future with attachments, my service type future no attachments, my service type past, not my service. Need to test with real attachments and add functions for adding the Id3 tags. Will also need to bundle this in a docker container for ease of deployment. 2025-06-11 16:46:35 -04:00			`LOGLEVEL = "INFO"`
README has started! Added some instructions and limitations to be aware of with the app. Add more logging messages. Added some testing functions to test the various webhook and user states that may be configured. Added an environmental variable for downloading some or all songs. Unfortunately, due to the various ways certain songs may be named (see comments and README), this is proving harder than usual. Added a function for applying the metadata to the final downloaded songs so that it can be picked up by Navidrome/Subsonic API. Split up a few functions into smaller functions. Tried adding some better logging and messaging around songs that are marked as non-downloadable and other messages. 2025-06-18 21:17:32 -04:00			`# Download All Files or only the ones that match Track Names? default=false`
			`# WARN: For the time being, keep ALLFILESBOOK as True as I am unsure what will happen with False.`
			`# While the goal was to give end users the option to only download specified tracks, there doesn't seem to be consistency in the file names to make this possible. My church has stuff like "PTTL" for Praise to the Lord (full band) and "IKAN_EG1_rehearsal" for I Know a Name - Guitar 1 rehearsal track. Plus, we don't use attachment_types, which is where a PCO admin might administer instruments or otherwise. I can't see right now how I'd scale this across the many churches implementing PCO.`

			`# TODO: Add option for specific instrument files to download.`
			`ALLFILESBOOL = "True"`
			`# Enter the artist name you want for the id3v2 tag so that the Subsonic API picks it up.`
			`ARTIST = ""`