Skip to content

Commit abc2c3d

Browse files
Merge pull request #938 from alexrhyshurn/main
Proposal to add some text to README on how to manage apps after installation using the WinApps Install Wizard as end user documentation
2 parents 3c1e7e1 + f2ddb72 commit abc2c3d

1 file changed

Lines changed: 28 additions & 2 deletions

File tree

README.md

Lines changed: 28 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -643,14 +643,40 @@ Once WinApps is installed, a list of additional arguments can be accessed by run
643643
644644
<img src="./docs/readme/installer.gif" width=1000 alt="WinApps Installer Animation.">
645645
646-
## Adding Additional Pre-defined Applications
646+
## Managing apps post-installation
647+
### Redetect and add new apps installed in Windows using the WinaApps Install Wizard
648+
The initial setup process will detect any Community Tested Applications and any additionally detected applications and make them available in your Linux application menu. If in the future you install a new application in Windows and want to add it to WinApps, you need to run the `winapps-setup` again to detect the new application(s).
649+
650+
The setup command has a number of options that can be passed to it:
651+
```
652+
winapps-setup --help
653+
Usage:
654+
--user # Install WinApps and selected applications in /home/$(whoami)
655+
--system # Install WinApps and selected applications in /usr
656+
--user --setupAllOfficiallySupportedApps # Install WinApps and all officially supported applications in /home/$(whoami)
657+
--system --setupAllOfficiallySupportedApps # Install WinApps and all officially supported applications in /usr
658+
--user --uninstall # Uninstall everything in /home/$(whoami)
659+
--system --uninstall # Uninstall everything in /usr
660+
--user --add-apps # Add new applications to existing installation in /home/$(whoami)
661+
--system --add-apps # Add new applications to existing installation in /usr
662+
--help # Display this usage message.
663+
```
664+
665+
To re-run the app detection, run the setup like
666+
```
667+
winapps-setup --user --add-apps
668+
```
669+
670+
This will bring up the familiar setup wizard screen and you step through the wizard as above choosing the apps you wish to make available. Note that if your Windows VM is not yet running, the setup will exit and tell you to start the VM first.
671+
672+
### Adding Additional Pre-defined Applications
647673
Adding your own applications with custom icons and MIME types to the installer is easy. Simply copy one of the application configurations in the `apps` folder located within the WinApps repository, and:
648674
1. Modify the name and variables to reflect the appropriate/desired values for your application.
649675
2. Replace `icon.svg` with an SVG for your application (ensuring the icon is appropriately licensed).
650676
3. Remove and reinstall WinApps.
651677
4. Submit a pull request to add your application to WinApps as a community tested application once you have tested and verified your configuration (optional, but encouraged).
652678
653-
## Running Applications Manually
679+
### Running Applications Manually
654680
WinApps offers a manual mode for running applications that were not configured by the WinApps installer. This is completed with the `manual` flag. Executables that are in the Windows PATH do not require full path definition.
655681
656682
```bash

0 commit comments

Comments
 (0)