Skip to content
This repository has been archived by the owner on Apr 6, 2023. It is now read-only.

How to use coapp

jonnybest edited this page Dec 6, 2011 · 3 revisions

To avoid confusing those doing the documenting, these would idealy be in the form of text files being approximately similar in appearance to 'man pages'.

End-Users

This paragraph tells you, the consumer, how to use CoApp.

Install

You don't actually need to install CoApp before using it. It will come automatically with your favorite CoApp-enabled software. If you've already installed some, proceed to 'Using the CoApp command line'. If you're interested in CoApp only, get the toolkit at http://coapp.org/install.

Open an 'elevated' command line on Windows 7

Coapp is an installation service and requires administrative privileges. You need to perform these steps before using any of these CoApp commands: install-package, remove-package, update-package. If you find the following instructions too complicated, you can install this tool and simply write "Elevate " in front of any of these CoApp commands.

  1. Open the start menu by clicking the Windows icon or pressing the [Windows key]
  2. Type 'cmd' into the search line
  3. Right-click the first result. It should read 'cmd'. Select "Run as administrator" from the context menu

How to open an elevated command line by right-clicking cmd.exe

If you don't have User Account Control enabled, you can simply open a command line window by pressing the [Windows key]+[R], then type 'cmd' (no quotes) and press [Enter].

Using the CoApp command line (and getting software)

  1. Open an elevated command line
  2. To see a list of commands that come with CoApp, type 'coapp --help'
  3. To display available software on CoApp, type 'coapp list-package'
  4. Find the software you like on the list and remember their name as noted in the first column, e.g. 'Node.js'.
  5. Is this the software you are looking for? Find out by typing 'coapp get-packageinfo name', e.g. 'coapp get-packageinfo Node.js'
  6. Type 'coapp install-package name' to install the software, e.g. 'coapp install Node.js'. Coapp will now proceed to download and install the selected package and all the other package your software needs to run.
  7. The new software is automatically registerd with Windows. As soon as the installation is complete, you can use it right from the command line or from wherever the package installed (e.g. C:\apps\bin)

Uninstall a software

  1. Open an elevated command line
  2. Type 'coapp list-package' and find the _name _of the package you'd like to remove. Removing a package will uninstall it from your computer.
  3. Type 'coapp remove-package name', e.g. 'coapp remove-package Node.js'. CoApp will now remove this package and other packages which are no longer needed.

Troubleshooting

  • If you run into any problems, try cleaning CoApp by running our Coapp cleaner. Careful: This will completely wipe your system of CoApp and all packages!
  • If that doesn't help and you're stuck, find us on IRC at irc.freenode.org in #coapp

Developers

(Documentation describing how to use the dev tools to make packages, upload to repositories, submit updates, etc.)

Clone this wiki locally