Playbook Creator: A free, open-source editor for American (Flag) Football Playbooks ==================================================================================== [![Build and Test](https://github.com/obraunsdorf/playbook-creator/actions/workflows/ci.yml/badge.svg)](https://github.com/obraunsdorf/playbook-creator/actions/workflows/ci.yml) This is a free editor for offensive playbooks in American Football. It is primarily dedicated to the flag football community as most of the teams (at least in Germany) cannot afford a commercial tool. Playbook Creator is mainly developed and tested on Linux, but you can download and run it on all major operating systems. * MacOS X * Windows 10 * Linux (Ubuntu 18.04) Mailing list: * send email (without registration): * subscribe for new messages/announcements: **I'm looking for developers who can help out on PBC. Any help is welcome. Please see the section `How to contribute to PBC` at the bottom.** If Playbook Creator is useful for your team, but none of you is able to contribute, you can also buy me a Radler at the next flag football tournament or you can donate some amount that you find appropriate on Paypal. [![Donate with PayPal](https://www.paypalobjects.com/en_US/i/btn/btn_donate_SM.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=E59SCLK3VYPLJ&source=url) ## How to install PBC * **On Windows** Download the latest release of Playbook Creator for Windows at https://github.com/obraunsdorf/playbook-creator/releases. This is a setup file. The Microsoft Defender installer will show a warning because of "Unknown publisher". Click on "Run anyway" and follow the instructions of the setup to complete the installation. (The warning is shown because I do not have Microsoft Developer Certificate because the cost some money). * **On MacOS X** Download the latest release of Playbook Creator for MacOSX at https://github.com/obraunsdorf/playbook-creator/releases. This is a DMG-file. Just open it and drag&drop the PlaybookCreator app to your Applications folder. => Open PlaybookCreator by right-clicking on it and select "Open". If you try to open it via double-click MacOS will complain that it cannot open the app because it is from an unidentified developer. This is because I am not a registered as a developer on Apple (see https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac) * **On Linux** 1. Install Qt: `apt-get install qt5-default` 2. Download Playbook Creator for Linux at https://github.com/obraunsdorf/playbook-creator/releases 3. Make it executable: `chmod +x path/to/PlaybookCreator` 4. Run it from the console: `path/to/PlaybookCreator` ## How to use PBC _Additionally to the explanations below, there is a great manual in German language with screen shots etc. at https://www.flagfootball.rocks/news/flag-football-playbook-designer-software.html_ Most of the user interface of Playbook Creator should be self-explainable. There is the main menu which can be used to, e.g. * create/open/safe a new playbook * create/open/safe/delete a play * export the playbook as pdf, arranged for using as a wrist coach When creating a new playbook, you can select the number of players (5, 7, 9 or 11). PBC is mostly tested for 5on5 playbooks. The next subsections shall be a little guide on how to create new plays and export a wrist coach from your playbook. ### Creating a New Formation In the main menu click `Play -> New play`. Enter whatever you want for play name / code name (these are discussed in the next section) and click OK. Move the players around using Drag&Drop. You can also set a color for a player by right-clicking on it and select `Set color`. If the formation is aligned as you wish, click `Play -> Save formation as` in the main menu. ### Creating a New Play In the main menu click `Play -> New play`. Enter a name for your play. The play name will be displayed in the bottom of the graphic. You can optionally choose a code name. If you set a code name then this one will be displayed in the bottom of the graphic instead of the original play name. We used this because our play names were super obvious. Therefore we had to use code names on our wrist coaches so that we could shout them out to make an audible at the LOS or call the play in a No Huddle Offense Choose the formation you like and click OK Now in the main screen, you can **right-click** on a player to * apply a route (from the route selection menu) * apply a motion * set her/his color You can also **double-click** on a player to quickly apply a route. Move your mouse and click to set a route point. While moving your mouse, you can also **Press 'Ctrl'** to draw a curved route. **Double-click** again to set the end of the route. If you designed your play don't forget to save it. In the main menu click `Play -> Save play` ### Using Categories After saving a play, you can assign it to custom categories (e.g. "run plays", "4th down plays", etc.). Click `Play -> Edit play's categories` in the main menu. There you can create new categories and assign the play to them. This is especially helpful if you later want to open plays of specific categories. The *Open play* dialog lets you apply category filters. ### Creating a New Route The quickly applied routes will not be added to your playbook. If you want to create new routes that shall be available in your route selection menu in the future, please do the following steps. 1. Right-click on a player 2. Select `Routes -> create (named) route` 3. Enter the route name (code name is optional here and will be displayed in the route selection menu) and click OK 4. Now proceed moving your mouse and set route points as usual. 5. Double click to set the end of the route and save the route. ### Creating a Wrist Coach If you created some plays, click `Playbook -> Create Wrist Coach (PDF)` in the main menu. A dialog will show up where you can see your plays on the left side. 1. Select every play you want to have on your wrist coach and use the button with the right arrow place them on the right list. 2. Use the buttons with the up and down arrow to change the ordering of the plays on the right site according to your planned wrist coach ordering 3. Enter the columns and rows your wrist coach should have 4. Enter the dimensions of one page that will fit into your physical wrist coach (in millimeters). The exported PDF will have exactly this size. 5. Most of the physical wrist coaches overlap the play sheets in some areas. You can select margins were nothing should be printed. The margins will be marked with a red dashed line 6. Click OK and select the file name where you want to save your PDF. 7. Enjoy ;) The created PDFs look will look like this one. If you quickly want to print your playbook. You can skip entering dimensions and margins. The page dimensions will be calculated automatically using your specified column and row count. ### Deleting Plays etc. If you want to delete some particular plays, categories, formations or routes from the playbook, simply click `Delete` in the main menu and choose accordingly. Deleting a formation or route will not have an impact on existing plays. The players will keep their routes and their positions/alignments. Deleting a category will not delete the plays within that category. It will only un-assign all plays from that category. ### Renaming Plays To rename a play you have to save it under a different name and then delete the old one. In particular: 1. Open the play you want to rename 2. Click `Play -> Save Play as` and choose a different play name (code name can stay the same as before). 3. Afterwards click `Delete -> Plays` and choose the old one to delete it. This is a little bit inconvenient. There will be a feature to easily rename plays, soon -- or sooner if you help programming PBC ;-) (see issue [#25](https://github.com/obraunsdorf/playbook-creator/issues/25)) ### Importing from another Playbook You can import another playbook. This is useful, e.g., when your teammates had some ideas for new plays and want to send them to you to import it in the team's playbook. Just click `Playbook -> Import Playbook` in the main menu. This feature is not fully complete yet. You can see the current progress in issue [#10](https://github.com/obraunsdorf/playbook-creator/issues/10). At the moment, when importing another playbook, it automatically imports all plays, categories, and formations from the other playbook. To make it easily visible which plays have been imported, their name is prefixed with 'imported_'. You can rename those plays after importing or you can delete them if you don't like them (see the sections above). Routes are not imported. Importing of routes is easily possible but I disabled it until we have a GUI dialog for import settings. If you urgently need to import routes, please make a comment to issue [#10](https://github.com/obraunsdorf/playbook-creator/issues/10) or write an email to the mailing list. ### Further Help and Discussion If you have any questions or want to discuss about Playbook Creator, you can use the issue tracking system of Github https://github.com/obraunsdorf/playbook-creator/issues. Alternatively you can write an email to the following mailing list . You can also subscribe to the mailing list here, to receive an email when new versions of PBC are released: http://www.freelists.org/list/pbc-users. Note: A (quite outdated) manual in PDF format is available [here](manual/pbcManual.pdf). The last page contains a step-by-step guideline to create a new playbook from scratch. I'll try to update the documentation in a new fancy manner as soon as I can. ## How to build PBC If you are using [VS Code](https://code.visualstudio.com/) and Docker, the easiest way to build PBC is by using the [.devcontainer](.devcontainer) files. ``` git clone https://github.com/obraunsdorf/playbook-creator.git cd playbook-creator code . # opens PBC in VS Code, then press F1 and type 'Open Folder in Container' ### Within the container, open terminal and type: mkdir build cd build cmake .. make ``` You can also refer to the [Github Actions CI Script](https://github.com/obraunsdorf/playbook-creator/blob/master/.github/workflows/ci.yml) to see how PBC is built natively on Linux, Windows and MacOS. ## How to contribute to PBC Feel free to contribute on any aspects of Playbook Creator: Front-end design, back-end code, crypto, documentation, website, etc. If you don't know where to start, please have a look at . Of course, you can also write me if you need some introduction to the code base or any other guidance. If you have any concrete idea, bug fixes, or even new code, you can either send me an email at or you can create an issue at If you are used to the github workflow, I am happy about every fork and pull request ;)