Welcome to the UBports community!
Please bear in mind, that we are a small community maintaining a full OS. Most work is done by volunteers in their free time. We are not a multi billion $ company. π€
Table of content
1. Swipe guestures in UT
2. How to unlock your device?
3. How to lock your device?
4. How to install a click file?
5. How to make a screenshot?
6. How to pin an app to the launcher?
7. What is the launcher and what is the drawer?
8. How do I get updates?
9. How to enable the torch (LED light)?
10. How to change the release channel?
11. How to dismiss the keyboard?
12. How to check app log files?
13. How does the indicator bar work?
14. How can I import and export contacts using a vcf file?
15. How to make a phone call?
16. Common actions in lists
17. How to enable developer mode
18. How to open and use the app spread?
19. Contact search in dialer app
20. How do I see missed calls?
21. How to copy a command or output in Terminal app?
22. How do I import and sync calendar events?
23. How do I find out if a bug has already been reported? How do I report bugs?
24. How can I set 24h format for times?
25. How can I delete all contacts in one step?
Ubuntu Touch by UBports
Please bear in mind, that we are a small community maintaining a full OS. Most work is done by volunteers in their free time. We are not a multi billion $ company. π€
Table of content
1. Swipe guestures in UT
2. How to unlock your device?
3. How to lock your device?
4. How to install a click file?
5. How to make a screenshot?
6. How to pin an app to the launcher?
7. What is the launcher and what is the drawer?
8. How do I get updates?
9. How to enable the torch (LED light)?
10. How to change the release channel?
11. How to dismiss the keyboard?
12. How to check app log files?
13. How does the indicator bar work?
14. How can I import and export contacts using a vcf file?
15. How to make a phone call?
16. Common actions in lists
17. How to enable developer mode
18. How to open and use the app spread?
19. Contact search in dialer app
20. How do I see missed calls?
21. How to copy a command or output in Terminal app?
22. How do I import and sync calendar events?
23. How do I find out if a bug has already been reported? How do I report bugs?
24. How can I set 24h format for times?
25. How can I delete all contacts in one step?
π3π2
1. Swipe guestures in UT
Ubuntu Touch does not (yet?) support hardware buttons for back or app spread functions. UT is guesture based. In general: swiping from the edges basically will do most stuff needed.
Swipe from left brings up launcher and drawer. Bonus feature: a four finger tap on the desktop does open the drawer and activates the search.
Long swipe from right opens the app spread. Short swipe from right changes between open apps.
Swipe from bottom reveals some additional pages in some apps.
Also this is a great short video explaining most of the swipes. Mind that staged mode is only available on larger screen devices.
Ubuntu Touch does not (yet?) support hardware buttons for back or app spread functions. UT is guesture based. In general: swiping from the edges basically will do most stuff needed.
Swipe from left brings up launcher and drawer. Bonus feature: a four finger tap on the desktop does open the drawer and activates the search.
Long swipe from right opens the app spread. Short swipe from right changes between open apps.
Swipe from bottom reveals some additional pages in some apps.
Also this is a great short video explaining most of the swipes. Mind that staged mode is only available on larger screen devices.
Telegram
Ubuntu Touch Usage
7. What is the launcher and what is the drawer?
2. How to unlock your device
UT has a lock screen just like most other mobile devices. Push left or right on the screen. If configured, you will get prompted for your pin/password. Then you will enter the main screen.
UT has a lock screen just like most other mobile devices. Push left or right on the screen. If configured, you will get prompted for your pin/password. Then you will enter the main screen.
3. How to lock your device
a) press the power button
b) don't touch your device for a while. The screen will lock itself after the time period specified in system settings.
a) press the power button
b) don't touch your device for a while. The screen will lock itself after the time period specified in system settings.
π1
4. How to install a click file (appname.click)
1. via Filemanager
- Open filemanager
- tap on the click file
- choose 'open with another app'
- select OpenStore as target in the next screen.
This will install apps provided as a click file.
2. via UT Tweak Tool
- open UT Tweak Tool
- in the hamburger menu (top left) select 'system'
- tap on ' install click package'
- select a file with the ' Pick...' button
- press 'Install' to install the app
3. via Terminal app (Xenial aka 16.04 only)
- open Terminal app
- change into the directory with the click file
- run `
1. via Filemanager
- Open filemanager
- tap on the click file
- choose 'open with another app'
- select OpenStore as target in the next screen.
This will install apps provided as a click file.
2. via UT Tweak Tool
- open UT Tweak Tool
- in the hamburger menu (top left) select 'system'
- tap on ' install click package'
- select a file with the ' Pick...' button
- press 'Install' to install the app
3. via Terminal app (Xenial aka 16.04 only)
- open Terminal app
- change into the directory with the click file
- run `
pkcon install-local --allow-untrusted foo.click` to install the appOpenStore
OpenStore - The open source app store for Ubuntu Touch
β€1
5. How to make a screenshot
option 1: press volume up and volume down simultaneously
option 2: press & hold the power button and select "screenshot" in the dialog
option 3: in system indicator select "switch off...", this opens the same dialog as in option 2, select "screenshot" in the dialog
option 1: press volume up and volume down simultaneously
option 2: press & hold the power button and select "screenshot" in the dialog
option 3: in system indicator select "switch off...", this opens the same dialog as in option 2, select "screenshot" in the dialog
6. How do I pin an app to the launcher (left side app bar)?
Open the app from the drawer. With the app still open, swipe from the left side until you see the launcher. Locate the icon of your app in the launcher. Press and hold this icon:
a) until the context menu shows up. Select "pin shortcut". Done.
b) move the icon to the desired position and release your finger. Done.
You can also rearrange the position of apps in the launcher. Press and hold the icon until the context menu shows up. Keep the icon pressed and move it up or down. Release your finger once the icon is in the desired position. You can of course reverse this to unpin.
Open the app from the drawer. With the app still open, swipe from the left side until you see the launcher. Locate the icon of your app in the launcher. Press and hold this icon:
a) until the context menu shows up. Select "pin shortcut". Done.
b) move the icon to the desired position and release your finger. Done.
You can also rearrange the position of apps in the launcher. Press and hold the icon until the context menu shows up. Keep the icon pressed and move it up or down. Release your finger once the icon is in the desired position. You can of course reverse this to unpin.
8. How do I get updates
System updates and app updates can be installed via system settings -> updates.
Apps can also be updated in OpenStore app.
Do NOT use apt for system updates!
System updates and app updates can be installed via system settings -> updates.
Apps can also be updated in OpenStore app.
Do NOT use apt for system updates!
Telegram
Ubuntu Touch FAQ
8. Can I use apt on Ubuntu Touch?
yesn't [yes and no]. Ubuntu Touch is built with privacy, reliability and stability accross a wide range of devices in mind. It is crucial that the developers are able to quickly reproduce and fix bugs across devices to ensureβ¦
yesn't [yes and no]. Ubuntu Touch is built with privacy, reliability and stability accross a wide range of devices in mind. It is crucial that the developers are able to quickly reproduce and fix bugs across devices to ensureβ¦
9. How to enable the torch (LED light)
This depends on the device. Many devices do have a switch in the power indicator. For some devices this can not be implemented this way. Then you can use uTorch app from OpenStore.
This depends on the device. Many devices do have a switch in the power indicator. For some devices this can not be implemented this way. Then you can use uTorch app from OpenStore.
OpenStore
OpenStore - The open source app store for Ubuntu Touch
10. How to change a release channel
There are two ways to change a release channel:
a) via system settings
- goto system settings -> updates
- press the settings icon (cogwheel) in the top right corner
- press channels
- select the channel you wish to use
- go back to the update page, there should now be an update ready to install the new channel
b) with the installer
- start the ubports installer and plug in your device
- select the channel for installation you want to use
!!! Unselect the wipe option to keep all your data and settings.
There are two ways to change a release channel:
a) via system settings
- goto system settings -> updates
- press the settings icon (cogwheel) in the top right corner
- press channels
- select the channel you wish to use
- go back to the update page, there should now be an update ready to install the new channel
b) with the installer
- start the ubports installer and plug in your device
- select the channel for installation you want to use
!!! Unselect the wipe option to keep all your data and settings.
Telegram
Ubuntu Touch FAQ
17. So many release channels in system update settings, where is the difference? π€
There are four release channels for Ubuntu Touch: stable, release candidate, devel and edge.
stable... is the most reliable release channel,
it is recommended for users whoβ¦
There are four release channels for Ubuntu Touch: stable, release candidate, devel and edge.
stable... is the most reliable release channel,
it is recommended for users whoβ¦
11. How to dismiss the keyboard
Tap & hold anywhere on the keybard. Then swipe down. The keyboard should disappear. You can then release the finger.
Tap & hold anywhere on the keybard. Then swipe down. The keyboard should disappear. You can then release the finger.
12. How to check app log files
a) The simplest option is to install logviewer app (blue/pink icon) from OpenStore. In this app you can conveniently view logfiles. The filter in the app's settings allows you to limit listed results.
b) In Focal logs can be obtained checking
c) In Xenial (16.04) Log files are stored on your device in the`~/.cache/upstart` folder. You can either
- head there using filemanager app to copy them somewhere else or
- use an editor like Seabass2 to view them on your device or
- check them using a terminal editor like
On Xenial generally logs are only kept while an app is open. If an app crash's, there will be no log. In this case temporary enable developer mode. Then logs will stay until the next reboot. On focal logs are kept for how long
a) The simplest option is to install logviewer app (blue/pink icon) from OpenStore. In this app you can conveniently view logfiles. The filter in the app's settings allows you to limit listed results.
b) In Focal logs can be obtained checking
journalctl. Some introduction can be found on the internet, for instance here and here. For example use this command to get logs for weather app and store them in a file called weather.log: journalctl --user -u lomiri-app-launch--application-click--weather.ubports_weather_6.0.2--.service >> weather.log. Omit the last part >> weather.log to see the log onscreen.c) In Xenial (16.04) Log files are stored on your device in the`~/.cache/upstart` folder. You can either
- head there using filemanager app to copy them somewhere else or
- use an editor like Seabass2 to view them on your device or
- check them using a terminal editor like
nano.On Xenial generally logs are only kept while an app is open. If an app crash's, there will be no log. In this case temporary enable developer mode. Then logs will stay until the next reboot. On focal logs are kept for how long
journalctl keeps them.OpenStore
OpenStore - The open source app store for Ubuntu Touch
π2β€1
13. How does the indicator bar work?
A community member thankfully made a tutorial video on the usage of the indicator bar. It is available here: https://rumble.com/v138w1m-pull-down-menu-in-ubuntu-touch.html
A community member thankfully made a tutorial video on the usage of the indicator bar. It is available here: https://rumble.com/v138w1m-pull-down-menu-in-ubuntu-touch.html
Rumble
Pull Down Menu In Ubuntu Touch
In this video we show how to properly utilize the pull down menu in Ubuntu Touch on a Pixel 3a phone.
14. How can I import and export contacts using a vcf file?
This can be done in the settings of contacs app. Open the app and tap the gear symbol in the top right corner to access the apps settings menu.
Import
- select "import from vcard file"
- tap on the file manager icon
- navigate to where your vcard file is and select that
- tap the βοΈ in the header to confirm your selection
Your contacts should now be imported.
Export
- select the "Export all contacts" option
- tap on the file manager icon
- navigate to the folder where you wish to store your vcard file
- tap the βοΈ in the header to confirm your folder selection
Your contacts are then exported to a file called "ubuntu_contacts_somedatestring.vcf"
This can be done in the settings of contacs app. Open the app and tap the gear symbol in the top right corner to access the apps settings menu.
Import
- select "import from vcard file"
- tap on the file manager icon
- navigate to where your vcard file is and select that
- tap the βοΈ in the header to confirm your selection
Your contacts should now be imported.
Export
- select the "Export all contacts" option
- tap on the file manager icon
- navigate to the folder where you wish to store your vcard file
- tap the βοΈ in the header to confirm your folder selection
Your contacts are then exported to a file called "ubuntu_contacts_somedatestring.vcf"
15. How to make a call
Okay, so you just put Ubuntu Touch on your phone and you are ready to go. It is a phone, so how about we make a phone call?
Unlock your device, swipe from the left edge to open the app drawer and search for a green icon with a white phone. Tap lightly on that. The Phone app will open.
Helpfully, it says 'Enter Number' and you can do just that with the keypad. With the number complete, tap the big green button and it will connect and turn red.
Top right you will see a star. That always means 'favourites' and will show your most used numbers. The head and shoulder icon will show all your numbers. Tap on the entry your want and dialling will start.
The gear-wheel thing is always 'Settings' of some kind but there actions hidden in there! If you are in a call and another one comes in, you can answer and say βring you back in 5β or whatever. You can also pass a caller to another number, such as a work phone or a colleague.
Oddly, this is also where you can check your balance or access voicemail. In other words, not Settings at all. Time we found a better iconβ¦
In a call, you have the normal option of using the volume up and down to change in-call volume. The speaker icon is obvious. Tap and untap to switch from holding up to your ear or listening and speaking at arm's length.
At the bottom of the dialling screen you will see a shallow up arrow. That is always a hint that you can swipe up. Do it here and you will find your call history.
Press the big red button to end the call and it will turn back to green. So, with the call ended, how do you get rid of the dial page? A pro hint here. The 'correct' answer is that you swipe inwards from the right edge of the screen. However, if you have a message list in an app, you can slide each message either left or right, to find 'Delete', 'Reply' etc. Sometimes the phone gets confused between Slide and Swipe. Understandable. So get into the habit of making your Swipe from the right edge at 45Β°. Across and down together. Then it will never be confused.
A minimised version of the Phone screen will appear. Just flick that either up or down to close the app.
Okay, so you just put Ubuntu Touch on your phone and you are ready to go. It is a phone, so how about we make a phone call?
Unlock your device, swipe from the left edge to open the app drawer and search for a green icon with a white phone. Tap lightly on that. The Phone app will open.
Helpfully, it says 'Enter Number' and you can do just that with the keypad. With the number complete, tap the big green button and it will connect and turn red.
Top right you will see a star. That always means 'favourites' and will show your most used numbers. The head and shoulder icon will show all your numbers. Tap on the entry your want and dialling will start.
The gear-wheel thing is always 'Settings' of some kind but there actions hidden in there! If you are in a call and another one comes in, you can answer and say βring you back in 5β or whatever. You can also pass a caller to another number, such as a work phone or a colleague.
Oddly, this is also where you can check your balance or access voicemail. In other words, not Settings at all. Time we found a better iconβ¦
In a call, you have the normal option of using the volume up and down to change in-call volume. The speaker icon is obvious. Tap and untap to switch from holding up to your ear or listening and speaking at arm's length.
At the bottom of the dialling screen you will see a shallow up arrow. That is always a hint that you can swipe up. Do it here and you will find your call history.
Press the big red button to end the call and it will turn back to green. So, with the call ended, how do you get rid of the dial page? A pro hint here. The 'correct' answer is that you swipe inwards from the right edge of the screen. However, if you have a message list in an app, you can slide each message either left or right, to find 'Delete', 'Reply' etc. Sometimes the phone gets confused between Slide and Swipe. Understandable. So get into the habit of making your Swipe from the right edge at 45Β°. Across and down together. Then it will never be confused.
A minimised version of the Phone screen will appear. Just flick that either up or down to close the app.
π2
16. Common actions in lists
Many UT apps do use lists to display data. Those lists do have some common actions that might not be known to new users:
- tap an item to trigger an action
- swipe a list item to the left or right to reveal more options, not all lists provide options on both sides (for example replying to messages or starting secret chats in Teleports)
- tap & hold a list item, this can trigger multiselect mode or allow to move items (if implemented in the app)
Many UT apps do use lists to display data. Those lists do have some common actions that might not be known to new users:
- tap an item to trigger an action
- swipe a list item to the left or right to reveal more options, not all lists provide options on both sides (for example replying to messages or starting secret chats in Teleports)
- tap & hold a list item, this can trigger multiselect mode or allow to move items (if implemented in the app)
17. How to enable developer mode
Open System Settings β scroll down, open About β open Developer mode, toggle Developer mode to on, reboot the device
Open System Settings β scroll down, open About β open Developer mode, toggle Developer mode to on, reboot the device