Desktop App
A brief overview of the Codio desktop app.
The desktop app is to allow a local code workspace to synchronize with a Codio box.
Units/Projects from the Classroom dashboard and My Projects area can be connected.
A Codio account is required
Excluding files
Files/folders can be excluded from synchronisation by using .codioignore
file in the source project.
Enter on a new line the file/folders to be excluded defining them relative to the location of the .codioignore
file and defining folders with /
For example if the .codioignore
file is located in the project workspace and you wish to exclude
bin
&node_modules
folder- the file
error.jade
in theviews
folder - the files
app.js
andREADME.md
the .codioignore
file will be
1 2 3 4 5 | /bin /node_modules /views/error.jade app.js README.md |
Please note that the .codioignore
file is included in the desktop app files.
If students wish to exclude files when pushing back to their Codio account they can do so, either by editing any existing .codioignore
file or creating the file themselves. If the teacher creates the .codioignore
file, adding a ‘comment’ line to the top of the file to make it clear to any students what they should not change could help avoid potential problems.
A line starting with #
serves as a comment
Click here to go to the download page and install to your local machine
Starting the app
When first starting the app you need to choose the server to connect to. In most cases this will be https://codio.com but if you are in the United Kingdom/Europe, it maybe https://codio.co.uk.
You can check by logging into your Codio account in your browser and you will see the server domain noted there
Having selected the server log in using your codio credentials.
Note: that if you usually access Codio through an LMS, you may not have a Codio account password set. If that is the case, go to the online login screen where you can go through the lost password process to define a codio account password. We would then recommend you log into your account online and change this password to one you will remember in the future. Setting a Codio account password will not effect or change how you currently access Codio via your LMS
Accessing and connecting to your online content
When logged in you can access your content either from My Classroom or My Projects area
Select either:
connect - to pull all the code from the selected unit to a folder on your PC that you define.
.
Open in Codio - to open the unit in your Codio account
When connecting, browse to a folder on your PC where you would like to store the code and pull the content
Managing your offline content
When you have connected you can then push/pull/open the unit in Codio and manage the local workspace folder settings.
1. Click the pull button to pull content in from your Codio account. Note Any files you already have stored locally will be overwritten
2. Click the push button to push the content from your local workspace folder back to your Codio account. Note This will overwrite the project/unit in your Codio account
3. Click the Open in Codio button to open your unit in a browser tab. This can be useful if you wish to compare what you have stored locally to what you last pulled from your Codio account
4. Click the folder icon to manage your local workspace folder settings
Local workspace folder settings
1. Click the Open the folder button to open the folder containing your local files
2. Click the Change folder button to change the folder storing your local files. Note the content of the previous folder will not be automatically copied or transferred to the newly selected folder. If you wish to do this, you should return to the previous screen and pull to that new folder
3. Click the Disconnect button to disconnect the unit from your Codio account. You will be returned to the previous screen where you can then connect the unit again if you wish