Menu ▾ ▴

Tree [afef1e] master v.1.3.3 /
 History

HTTPS git://
HTTPS access

File Date Author Commit
 .idea 2024-09-04 Jeremy Wilson Jeremy Wilson [afef1e] Updated version number
 .vs 2024-04-23 Jeremy Wilson Jeremy Wilson [c49cf0] Initial Commit
 compile_config_and_installers 2024-09-04 Jeremy Wilson Jeremy Wilson [afef1e] Updated version number
 ghostscript 2024-05-03 pastorjeremywilson pastorjeremywilson [64cd0d] Added ability to print the order of service
 resources 2024-08-24 Jeremy Wilson Jeremy Wilson [412f69] Added update check at startup.
 static 2024-04-23 Jeremy Wilson Jeremy Wilson [ace788] Initial Commit
 README.html 2024-09-04 Jeremy Wilson Jeremy Wilson [afef1e] Updated version number
 README.md 2024-09-04 Jeremy Wilson Jeremy Wilson [afef1e] Updated version number
 ToDo 2024-08-27 Jeremy Wilson Jeremy Wilson [d42b72] Fixed extra space in bible chapter in preview t...
 edit_widget.py 2024-09-04 Jeremy Wilson Jeremy Wilson [bff161] Update edit_widget.py
 formattable_text_edit.py 2024-07-26 Jeremy Wilson Jeremy Wilson [5f6bea] Organized/refactored items in the resources folder
 get_scripture.py 2024-07-19 Jeremy Wilson Jeremy Wilson [9bbdae] Switched from Qt6 to Qt5 to alleviate a couple ...
 gui.py 2024-09-04 Jeremy Wilson Jeremy Wilson [afef1e] Updated version number
 help.py 2024-07-19 Jeremy Wilson Jeremy Wilson [9bbdae] Switched from Qt6 to Qt5 to alleviate a couple ...
 importers.py 2024-08-08 Jeremy Wilson Jeremy Wilson [ebb58e] Fixed wrong number of list items for saving son...
 live_widget.py 2024-07-26 Jeremy Wilson Jeremy Wilson [5f6bea] Organized/refactored items in the resources folder
 main.py 2024-09-04 Jeremy Wilson Jeremy Wilson [6cfc0a] Fixed extra space in lyrics after saving a new ...
 media_widget.py 2024-09-04 Jeremy Wilson Jeremy Wilson [e5378a] Ensured that blank lines before and after lyric...
 oos_widget.py 2024-08-09 Jeremy Wilson Jeremy Wilson [7d6425] Fixed bible combobox not updating after importi...
 openlp_import.py 2024-08-08 Jeremy Wilson Jeremy Wilson [ebb58e] Fixed wrong number of list items for saving son...
 openlyrics_export.py 2024-07-23 Jeremy Wilson Jeremy Wilson [060f9b] Changed most "pressed" signals to "clicked" to ...
 parse_scripture_reference.py 2024-05-03 Jeremy Wilson Jeremy Wilson [ea8d4c] Added documentation to parse_scripture_referenc...
 preview_widget.py 2024-07-23 Jeremy Wilson Jeremy Wilson [060f9b] Changed most "pressed" signals to "clicked" to ...
 print.pdf 2024-07-10 Jeremy Wilson Jeremy Wilson [54945b] Fixed missing font settings in edit widget when...
 print_dialog.py 2024-07-26 Jeremy Wilson Jeremy Wilson [5f6bea] Organized/refactored items in the resources folder
 projecton.bat 2024-04-23 Jeremy Wilson Jeremy Wilson [ace788] Initial Commit
 settings_widget.py 2024-07-25 Jeremy Wilson Jeremy Wilson [646e5a] Futher refined the light and dark themes.
 simple_splash.py 2024-08-10 Jeremy Wilson Jeremy Wilson [1c2de4] Ensured that files created when importing a vid...
 songselect_import.py 2024-08-10 Jeremy Wilson Jeremy Wilson [1c2de4] Ensured that files created when importing a vid...
 toolbar.py 2024-07-26 Jeremy Wilson Jeremy Wilson [5f6bea] Organized/refactored items in the resources folder
 web_remote.py 2024-08-24 Jeremy Wilson Jeremy Wilson [412f69] Added update check at startup.
 widgets.py 2024-09-04 Jeremy Wilson Jeremy Wilson [e5378a] Ensured that blank lines before and after lyric...

Read Me

<p><a href="https://github.com/pastorjeremywilson/ProjectOn/pulse/monthly"><img src="https://img.shields.io/badge/status-active-brightgreen.svg?style=plastic" alt="Status"></a>
<a href="https://www.gnu.org/licenses/gpl-3.0.en.html"><img src="https://img.shields.io/badge/license-GPL-blue.svg?style=plastic" alt="License"></a></p>
<p><img src='https://github.com/pastorjeremywilson/public/blob/main/projecton-banner.svg?raw=true' width='300px' /></p>
<h1 id="what-am-i-">What Am I?</h1>
<p>ProjectOn is an open-source multimedia projection program geared towards
producing and running church services.</p>
<p>&nbsp;</p>

<h1>What's New in Version 1.3.3?</h1>
<p>Some important bug fixes:</p>
<ul>
    <li>Leading and trailing blank lines are now stripped from song lyrics</li>
    <li>Unwanted blank lines are no longer inserted when saving a song</li>
    <li>Videos now show in the preview area of the Live panel while playing</li>
</ul>

<h1 id="why-projecton-">Why ProjectOn?</h1>
<p>Working in a smaller church, I was limited by a small budget, the small
number of open-source church projection programs available, and few
tech-savvy volunteers. ProjectOn seeks to provide an easy to use,
intuitive, and responsive experience when building and running the
projection needs of a church service.</p>
<p>&nbsp;</p>

<h1 id="installation">Installation</h1>
<p>Currently, ProjectOn is available for the Microsoft Windows operating
system only. Download the current ProjectOn installer (v.1.3.3) and run
it on your computer.</p>
<p>&nbsp;</p>

<h1 id="using-projecton">Using ProjectOn</h1>
<p>This information will get you started, but for more in-depth information
on using ProjectOn, please click “Help” and “Help Contents” in the menu.</p>
<p>&nbsp;</p>

<h3 id="screen-layout">Screen Layout</h3>
<p>When you first run ProjectOn, you’ll be greeted with a screen split into
four main areas:</p>
<ul>
<li><p>Order of Service</p>
</li>
<li><p>Media Storage</p>
</li>
<li><p>Preview Panel</p>
</li>
<li><p>Live Panel</p>
</li>
</ul>
<p>The Order of Service area is where you will place the various items to
show during your service, such as music lyrics, bible verses, and
images. Drag-and-drop items into this area from the Media Storage area
or use the Media Storage’s Add to Service buttons. Drag items in the
Order of Service to rearrange their order.</p>
<p>In the Media Storage area, you will find tabs for the various types of
media that can be displayed:</p>
<ul>
<li><p>Song Lyrics</p>
</li>
<li><p>Bible Verses</p>
</li>
<li><p>Custom Slides</p>
</li>
<li><p>Images</p>
</li>
<li><p>Videos</p>
</li>
<li><p>Web Slides</p>
</li>
</ul>
<p>The Preview Panel shows you the content of what is coming up next in the
service, while the Live Panel shows you the content of what is currently
being displayed.</p>
<p>&nbsp;</p>

<h3 id="remote-interfaces">Remote Interfaces</h3>
<p>The ProjectOn program, while it is running, creates a server that can be
accessed by any browser on any device connected to the same network or
access point. This server has three different web pages that can be
accessed:</p>
<ul>
<li><p>Remote Control</p>
</li>
<li><p>Mobile-Friendly Remote Control</p>
</li>
<li><p>Stage View</p>
</li>
</ul>
<p>The Remote Control provides an application that allows you to control
the service through another device, such as a tablet or smartphone.</p>
<p>The Stage View shows a simplified version of any text that is currently
being displayed on the projector. This is particularly useful for
showing lyrics to a Praise Team.</p>
<p>The specific web pages for these can be found by choosing “Help” and
“About” from the menu.</p>
<p>&nbsp;</p>

<h3 id="settings">Settings</h3>
<p>There are various changes that can be made to how ProjectOn works. By
clicking on the settings icon, you will see what those changes are:</p>
<ul>
<li><p>CCLI Info</p>
</li>
<li><p>Screen Settings</p>
</li>
<li><p>Global Font Settings</p>
</li>
<li><p>Global Background Settings</p>
</li>
</ul>
<p>If you have an account with CCLI (Christian Copyright Licensing
International), you can enter your license number(s) here. This will
ensure that your license number appears on any lyrics shown on the
projector.</p>
<p>In the Screen Settings you can choose which screen you would like to use
as your display. By default, the program uses whatever monitor is
currently set up as your “Primary” monitor and, if a second monitor or
projector is already connected to the computer, uses that as the
display.</p>
<p>In the Global Font section, you can change the appearance of the text
that is being displayed. You’ll find options for the Font Face, Size,
Shadow, Outline, and Color of the text. Here, too, you can change the
size of the font that appears on the Stage View.</p>
<p>In the Global Background section you can choose the default background
for songs and for bible passages. These changes can also be made in the
toolbar at the top of the main window. Songs and bible verses will
automatically used these backgrounds, unless you specify a custom
background to use when editing a song.</p>
<p>Here, too, you can choose a custom “Logo” image to display when nothing
else is being shown; for example, a graphic with a welcome message.</p>
<p>&nbsp;</p>

<h3 id="shortcut-keys">Shortcut Keys</h3>
<p>There are a variety of Shortcut Keys that can be used when using the
program or navigating a service:</p>
<p><table></p>
<p><tbody></p>
<p><tr class="even"></p>
<p><td><p><strong>Key</strong></p></td></p>
<p><td><p><strong>Function</strong></p></td></p>
<p><td><p><strong>Description</strong></p></td>
</tr></p>
<p><tr class="odd"></p>
<p><td><p>Space Bar</p></td></p>
<p><td><p>Send to Live</p></td></p>
<p><td><p>Takes the currently highlighted item in the Preview Pane and
shows it on the display</p></td>
</tr></p>
<p><tr class="even"></p>
<p><td><p>Down Arrow</p></td></p>
<p><td><p>Next Slide</p></td></p>
<p><td><p>Shows the next slide in the Live Panel or, if it is on the last
slide, shows the next service item</p></td>
</tr></p>
<p><tr class="odd"></p>
<p><td><p>Up Arrow</p></td></p>
<p><td><p>Previous Slide</p></td></p>
<p><td><p>Shows the previous slide in the Live Panel or, if it is on the
first slide, shows the previous service item</p></td>
</tr></p>
<p><tr class="even"></p>
<p><td><p>Right Arrow</p></td></p>
<p><td><p>Next Service Item</p></td></p>
<p><td><p>Shows the next item in the Order of Service area</p></td>
</tr></p>
<p><tr class="odd"></p>
<p><td><p>Left Arrow</p></td></p>
<p><td><p>Previous Service Item</p></td></p>
<p><td><p>Shows the previous item in the Order of Service area</p></td>
</tr></p>
<p><tr class="even"></p>
<p><td><p>Ctrl-S</p></td></p>
<p><td><p>Save</p></td></p>
<p><td><p>Saves the current Order of Service</p></td>
</tr></p>
<p><tr class="odd"></p>
<p><td><p>Ctrl-O</p></td></p>
<p><td><p>Open</p></td></p>
<p><td><p>Opens a saved Order of Service</p></td>
</tr></p>
<p><tr class="even"></p>
<p><td><p>Ctrl-N</p></td></p>
<p><td><p>New</p></td></p>
<p><td><p>Creates a new Order of Service</p></td>
</tr></p>
<p><tr class="odd"></p>
<p><td><p>Ctrl-P</p></td></p>
<p><td><p>Print</p></td></p>
<p><td><p>Creates a printout of the current Order of Service</p></td>
</tr></p>
<p><tr class="even"></p>
<p><td><p>Ctrl-D</p></td></p>
<p><td><p>Show/Hide Display</p></td></p>
<p><td><p>Show or Hide the Display Screen (hiding the display screen shows
the desktop underneath is)</p></td>
</tr></p>
<p><tr class="odd"></p>
<p><td><p>Ctrl-B</p></td></p>
<p><td><p>Blank/Restore Display</p></td></p>
<p><td><p>Blank or restore the Display (turn the display all
black)</p></td>
</tr></p>
<p><tr class="even"></p>
<p><td><p>Ctrl-L</p></td></p>
<p><td><p>Logo</p></td></p>
<p><td><p>Change the display to your logo image</p></td>
</tr></p>
<p><tr class="odd"></p>
<p><td><p>Ctrl-Alt-S</p></td></p>
<p><td><p>Settings</p></td></p>
<p><td><p>Open the settings window</p></td>
</tr></p>
<p><tr class="even"></p>
<p><td><p>F1</p></td></p>
<p><td><p>Help</p></td></p>
<p><td><p>Open the help window</p></td>
</tr></p>
<p><tr class="odd"></p>
<p><td><p>Ctrl-A</p></td></p>
<p><td><p>About</p></td></p>
<p><td><p>Open the “About” window</p></td>
</tr>
</tbody>
</table></p>
<p>&nbsp;</p>

<h1 id="technologies-and-credits">Technologies and Credits</h1>
<p><br></p>
<p><div>
    <img src='https://github.com/pastorjeremywilson/public/blob/main/python-logo-only.svg?raw=true' width=40px align='right' />
    ProjectOn is written primarily in <a href="https://www.python.org" target="_blank">Python</a>, compiled through <a href="https://www.pyinstaller.org" target="_blank">PyInstaller</a>,
    and packaged into an installation executable with <a href="https://jrsoftware.org/isinfo.php" target="_blank">Inno Setup Compiler</a>.
</div>
<br></p>
<p><div>
    <img src='https://github.com/pastorjeremywilson/public/blob/main/sqlite370.jpg?raw=true' height=40px align='right' />
    ProjectOn’s main database is <a href="https://www.sqlite.org" target="_blank">SQLite</a> and the remaining data files are
    stored in the <a href="https://www.json.org/json-en.html" target="_blank">JSON</a> format.
</div>
<br></p>
<p><div>
    <img src='https://github.com/pastorjeremywilson/public/blob/main/Qt-logo-neon.png?raw=true' height=40px align='right' />
    ProjectOn uses <a href="https://www.qt.io/product/framework" target="_blank">Qt</a> (PyQt5) for the user interface.
</div>
<br></p>
<p><div>
    <img src='https://github.com/pastorjeremywilson/public/blob/main/ghostscript-plus-text.png?raw=true' height=40px align='right' />
    Printing made possible with the help of Artifex Software&#39;s <a href="https://www.ghostscript.com" target="_blank">Ghostscript</a>.
</div>
<br></p>
<p>Many thanks to my wife, who dealt with innumerable crashes and updates
while this program was being developed.</p>
<p>All trademarks (c) their respective owners.</p>
<p>&nbsp;</p>

<h1 id="licensing">Licensing</h1>
<p><br></p>
<p><img src='https://github.com/pastorjeremywilson/public/blob/main/gnu-4.svg?raw=true' height=120px align='left' />
ProjectOn is licensed under the GNU General Public License (GNU GPL)
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version. See
<a href="http://www.gnu.org/licenses/" target="_blank">http://www.gnu.org/licenses/</a>.</p>