bitfocus / companion

Bitfocus Companion enables the reasonably priced Elgato Streamdeck and other controllers to be a professional shotbox surface for an increasing amount of different presentation switchers, video playback software and broadcast equipment.
http://bitfocus.io/companion
Other
1.47k stars 489 forks source link

Export a PDF Guide of Configurations for training crew, volunteers, clients #2934

Open davidjoshuaford opened 5 days ago

davidjoshuaford commented 5 days ago

Is this a feature relevant to companion itself, and not a module?

Is there an existing issue for this?

Describe the feature

PROBLEM: DIFFICULT TO TRAIN PEOPLE ON CUSTOM CONFIGS

For large configurations, keeping track of what each button does to train a crew, volunteer, or client becomes as much manual work as designing the functions themselves. Plus with each small change to a configuration (moving buttons, changing actions or delay times) it's hard (ie very slow and laborious) to keep an accurate log in a separate document of what buttons do.

ADD A "DESCRIPTION" FIELD

The main field to add for each button would be a text based "Description" field under the name string. While the button name string is useful, often it has strange variables in it, and it would be cleaner to output a Description field. This should accept new lines, so that multi-actions can be clearly laid out in the description.

Screenshot 2024-06-27 at 8 02 16 PM 2

PDF PRINTED GUIDE

It would be amazingly helpful if Companion could output a PDF Guide for physical printing or sending digitally. This would included a screenshot of the page for reference, and in its most basic form a list underneath of the button number (0/1) and the text from the Description field. There would be options to modify:

Here are some mockups:

Companion Button Print Guide (0) Companion Button Print Guide (1) Companion Button Print Guide (2)

EXPORT ATTRIBUTES VIA CSV

Further, it would be great to be able to select what attributes you want to output for more details in a spreadsheet/ CSV format. These could include:

Screenshot 2024-06-27 at 9 10 48 PM

HOVER FOR TOOL TIPS

Other ideas could be the "Description" field text appearing as a tooltip alongside the 0/0 button numbers when you hover over them in on the Buttons tab, or on the emulator.

Screenshot 2024-06-27 at 9 12 40 PM

THE BENEFIT

The benefit of storing the description in Companion on every button is that as profiles are chopped/changed/added to, the description of the button travels with that button.

Usecases