Testing a development version of Subsurface

General Info

  • Translations often aren’t available for all supported languages before fairly late in the beta cycle. You can check the status on https://www.transifex.com/projects/p/subsurface/ or better participate and improve the translations.
  • When testing a beta version something unexpected can happen with your data. Therefore use a backup copy of your real logbook for testing purposes.
  • You probably don’t use/test all features. The list below contains some hints of things to look at
  • Use you own imagination when entering data. If you have further ideas, what to test, please proceed.
  • Please report bug using https://github.com/Subsurface-divelog/subsurface/issues/
  • If you encounter no problems, please provide feedback, too. Either through the mailing list or https://subsurface-divelog.org/user-forum/ (user forum). Please mention which version of subsurface you are testing. The easiest way to do this is to look at the About dialog (under Help on Windows and Linux, and under the Subsurface menu on the Mac). Also mention the OS and version you are using – if on Linux, mention the distribution as well.

Basic test

I. Installation/Start of App

If on Microsoft Windows: is the correct version number shown in Start → System settings → Programs?

Does Subsurface start at all? Any issues with the process (dependencies missing on Linux, other problems?)

II. GUI

1. General

  • If a new installation, is the main window divided into four parts, otherwise is the setup of the last usage restored, eg a single window, the dive list?
  • Is every item of the menu translated?
  • Are any shortcuts shown?
  • Which shortcut doesn’t work?

2. Preferences

  • Do changed settings take effect? eg. change of language
  • Network settings: if a local proxy is available: does setting the proxy work?

III. Use cases

for #1 to #3 try all these steps both with and without an existing logbook to start with.

1. manually add new dives

  • Manually enter random data for some dives (4 or 5).
  • At least for one dive use the globe to add position data.
  • Select a dive and use CTRL+C to copy some of this data into another dive.
  • Use the same procedure to create a new dive.
  • Group 2 or 3 consecutive dives as a trip,
  • Delete one dive,
  • Merge 2 or more dives into one dive
  • Save the dives to a logbook, close and open Subsurface again.
  • Open the specific logbook. Check if all data is ok

2. planning a new dive

  • Plan a new dive. Add your own choice of data for this dive.
  • Save the plan.
  • Replan this dive.
  • Save the dive again.

3. Import data

If you have access to a dive computer, please test downloading data from a dive computer. Alternatively, it is fairly easy to set up the libdivecomputer simulator to pretend to have a dive computer to download from. http://www.libdivecomputer.org/simulator.html should have all the information you need.

On Linux, these steps should get you started:

  • in one terminal, run
    socat PTY,link=/tmp/ttyS0 PTY,link=/tmp/ttyS1
  • in a second terminal, run
    ./universal -b atom2 -m 0x454C -p /tmp/ttyS0 A300CS.bin

    with the data file provided in our download area

  • now run Subsurface and download from an Aeris A300CS with /tmp/ttyS1 as the device (this will NOT be offered automatically, you need to manually specify it)

Now that you can download from a real or fake divecomputer, please try the following

  • Check if these dives have been added to a new trip
  • start download,
  • select “Force download of all dives” and “Download into new trip”
  • Open Download from dive computer again,
  • Does downloading take significantly longer than expected (compared with previous downloads)?
  • Are only the latest dives (not already in the logbook) downloaded?
  • Restart downloading data from the dive computer.
  • Restart Subsurface, open the last logbook and check the data of the logbook
  • Save the data into a new logbook.
  • Manually add data to some of the downloaded dives
  • interrupt downloading (not supported by every dive computer) and select some of the dives and save this download.
  • Start the download procedure
  • Restart Subsurface, open no logbook

  • Next test downloading dves from divelogs.de. A test account (subsurfacetest / geheim) exists for this purpose. Try uploading newly added dives as well.
  • If you have access to the Subsurface sources, test opening the log files under dives/ - there are many test files plus some sample log files from other applications.

  • Test opening log files from previous versions of Subsurface and any other log files you have access to from other apps you use or have used in the past

  • If you have used the Android Companion App in the past, test import GPS data from Subsurface web service

4. Manipulating an existing logbook

  • Try everything related to right-click / context menu on dive list, eg
    • renumbering dives
    • creating and deleting trips
    • shift times
    • add photos
  • Use the context menu on the profile to add bookmarks and gas changes, to remove events
  • Use the globe to add / modify dive locations
  • Use the Dive notes and Equipment tab to modify dive data

5. Filter data

  • Select Log → Filter devicelist [CTRL-+F) and select some of the tags.
  • Check the result, are the counts correct? Are the correct dives shown.
  • Use some of the tags to filter your data further.