LaunchMeUp Assistant
LaunchMeUp Assistant is used to communicate with the magiczee.com cloud, including retrieving themes or publishing them. It can also be used to modify the configuration of an application already present on the computer.
How to launch LaunchMeUp Assistant
Once LaunchMeUp is installed on your computer, a shortcut is available on the desktop as well as in the Windows start menu.
Login
The first screen of the wizard is the one allowing connection. A valid account created on magiczee.com is therefore necessary (see the “Membership” section of the site). Creating this account is free.
It is also possible to change the display language using a drop-down list at the top right of the wizard.
What LaunchMeUp Assistant allows
The wizard will cycle through a certain number of forms (steps) depending on the action you have chosen. The “next” and “previous” buttons allow you to move from one step to another.
The first step after connection gives access to three possible choices:
Create an app
This choice will allow you to retrieve a theme from magiczee.com to transform it into a perfectly configured application that can be executed with the Player.
Edit an app
It is also possible to modify the settings of an application already present on the computer. The steps are almost identical to the “Create an app” choice.
Manage your themes
This choice allows the publication and sharing of your themes on magiczee.com, so that they can be retrieved by the community or by a limited number of people.
Create an app
Step 1: Selecting a Theme
At this stage, you can retrieve a theme from magiczee.com or directly use a zip archive containing a theme.
- Selection of a theme on magiczee.com
This option gives access to the list of themes that the community has shared on magiczee.com. You can filter this list according to free entry or by type of theme, you can also sort the list according to 3 different criteria.
It is also possible to only display the themes that you have published yourself by checking the appropriate box.
Refreshing the list is done by clicking on the “Search” button, the search result is paginated.
- Using a theme present on the computer
By clicking on “Select a theme on this computer”, you will be able to select or drag a .zip theme archive stored on your computer.
Step 2: Selecting a Destination Directory
Once the theme is chosen, the next step is to select a path on your computer's file system for building your application.
The generation directory must be empty.
Step 3: Download external packages
The creator of a theme has the possibility of specifying a certain number of packages (media, ROMs, etc.) hosted on the internet which will be downloaded by the user of the theme via this step of the wizard.
User can select/deselect the packages they want to download before clicking “Next”.
The download may take more or less time depending on the size of the packages and the quality of the internet connection.
Note: if the theme author has not specified any external downloadable package, this step does not appear in the wizard.
Step 4: configure application windows
LaunchMeUp Player allows multiwindowing, for example to display a window on each screen present. This step is useful for modifying the window settings defined by default by the theme author.
The editable information for each window is:
-
Screen: in which screen the window should appear
-
Position (initial): coordinates, maximized or screen center
-
Rotation: it is possible to specify a rotation for the windows in increments of 45°, useful for example for the pincabs playfield.
-
Visible: you can choose not to display certain windows
-
Border: without, simple, 3D, tool
-
Sizing: can we resize the window? No, minimizeable only, resizable, resizable with grips
-
Positions: in the case of “Position” type positioning, position in pixels of the window (left, top, width, height).
-
Calibration: a calibration button brings up a window to move to easily define the settings.
Step 5: Configure application controls
This step is useful for defining how the application will be controlled. The possible controls come from the keyboard and joysticks (and also the mouse).
Each possible action in LaunchMeUp can be associated with 3 different controls.
The “+” and “-” buttons allow you to add/remove a control.
Step 6: Setting up the app theme
The creator of a theme has the possibility to specify a number of theme properties easily modified using this step of the wizard (eg: application title, text color, display or not certain elements, font character to use, etc.).
Theme properties can be grouped by categories.
Step 7: Complete the application generation
Once the application has been correctly configured using the previous steps of the wizard, accessing the last step will generate the application in the directory chosen by the user. It will then be executable with the Player.
This last step asks the user what they want to do from now on:
-
Launch your newly generated application with the Player
-
Restart the wizard at the initial stage
-
Access the theme author's web page (if defined)
-
Note the theme (if you are not its author)
-
Exit the wizard
Edit an application
The first step of the wizard allows the user to choose to modify the settings of an application that has already been generated.
The steps that will be presented are then the same as those for creating an application, except for selecting the theme.
Manage my themes
LaunchMeUp is based on a close-knit community that shares themes on the magiczee.com cloud. The “Manage My Themes” option in the wizard allows you to become part of this community by publishing and sharing your own themes.
Step 1: Select a theme and take action
This step of the wizard displays the list of your themes. She permits :
-
Selecting one of your themes to modify it, modify its publication, or delete it
-
Adding and publishing a new theme
Step 2: Add or edit a theme
By clicking on “Next” after selecting the “Add” or “Edit” option, you access the step of defining your theme.
Selecting theme file path
This is the directory in which your theme is stored, previously designed with the editor. Once the path is defined, the program allows you to select the files you want to include in your theme. For information, the zipped size of a theme stored on the magiczee.com platform cannot currently exceed 5 MB. In addition, the authorized extensions are also limited.
Edit general information
The general information of your theme is:
-
Thumbnail: image or logo of your theme (required)
-
Title (required, and must be unique on magiczee.com)
-
Description in a few sentences, line break possible
-
Type: desktop, arcade machine, pincab, jukebox or other
-
Version: integer value (required, must be incremented if you modify an existing theme)
-
Author page: your web page, Facebook, blog, etc.
-
Remixed from: if your theme is a remix of another theme (the author must have authorized the remixes)
-
Allow remixes of your theme by other users
Set list of editable properties
It is possible to define properties here that the user of your theme will be able to modify after downloading it with this wizard (eg: title of the application, color of the text, display or not certain elements, font to use , …).
This part of the theme definition requires a good knowledge of how pages are defined in LaunchMeUp themes (see the reference manual with the description of the components and their properties).
These properties will modify certain definitions of the elements of the pages of your theme, according to the choices of the user who downloaded it.
You can add a property after selecting its type from the drop-down list:
-
Free text entry by the user
-
Entering an integer value
-
Entering a decimal value
-
Check box yes/no
-
Selection of one or more values from a drop-down list
-
Selecting a file
-
Selection of a font
-
Selection of a color
-
Selection of a numerical value using a gauge
Properties share a certain amount of common information, and have others depending on each type. Help is displayed when the mouse hovers over the areas to be entered.
-
Property title (which will be presented to your theme user)
-
Description (free entry on several lines, displayed on mouseover to help the user of your theme)
-
Destination: this is a pair
. which will indicate which property of which element of your theme will be affected by the user's choice. It is therefore important to name your theme components correctly in the editor. -
Entering an integer value
Minimum value that can be entered.
Maximum enterable value.
- Entering a decimal value
Minimum value that can be entered.
Maximum enterable value.
- Check box
Checked box value, to assign to your theme when the user checks the box
Unchecked box value, to assign to your theme when the user does not check the box
- Selection of one or more values from a drop-down list
Multi selection allowed: the user will be able to select several values in the list and not just one.
List of possible values: a series of pairs
- Selecting a file
Operation to perform: should you copy or move the selected file into the theme directory, or should you leave it in its place.
Destination Directory: Destination relative path in the application directory.
- Selection of a font
List of font names, separated by commas. Note: it is possible to define a path in the theme in the editor which contains your own custom fonts.
- Selection of a color
List of names or definitions (#AARRGGBB) of user-selectable colors in a drop-down list, separated by commas.
- Selection of a numerical value using a gauge
Minimum selectable value.
Maximum selectable value.
Set list of downloadable packages
As the size of themes publishable on magiczee.com is limited, and embeddable file extensions must satisfy a reduced list, there is the possibility of allowing the user of your theme to download packages hosted elsewhere on the internet (media packs, …).
To do this, click on the “+” button on this page and provide the following information for each package:
-
Title: displayed to inform the user of your theme about the nature of the package.
-
Source: URL of your package on the internet
-
User/password: if the package is protected by a login/password from its hosting site, enter them here. Note: only magiczee.com knows these credentials, they are not transmitted to other users. The same goes for the source URL.
-
Relative destination in the generated theme/app directory. A right click allows you to select one of the subdirectories present in your theme.
-
Unzip: do you need to unzip the file once downloaded by the user of your theme.
Set publishing mode
Here you can choose how your theme will be seen by other LaunchMeUp users.
-
Private: only you will see your theme, useful for development and testing.
-
Public: everyone will see and be able to use your theme.
-
Visible but restricted access: the theme is visible to everyone, but you choose the list of users who can use it (list of email addresses).
-
Only visible and usable by the people you have defined (list of email addresses).
The last two options are only available for pro membership.
Step 3: theme validation log
Once your theme is fully defined, clicking on “Next” gives you access to a theme validation log. Publication is only authorized from the moment when no error message appears in the log (messages in red).
In the event that one or more error messages appear, it will be necessary to go back to correct the errors cited.
Step 4: Publish the theme
If the theme validation log allows you to do so, you can publish the theme by clicking on “Next”. A message will inform you after a few seconds of the effective publication of the theme. However, there remains a validation step by the magiczee.com platform so that other users have access to your publication.
Step 2a: delete a theme
Select one of your themes, check the “delete” option, and click next.
A confirmation message is displayed (the theme will be permanently deleted from the magiczee.com cloud, it will not be possible to go back). Then the theme is deleted.
Third-party step 2: Edit the post
This option allows you to modify the publication mode of your theme, as described above.