SecureView - SFTP Viewer (0.05 alpha 10-May-2026)

The latest version is available from https://www.riscosports.co.uk/vfp/SecureView.zip

The !SecureView application is just a simple front end onto the libssh2 library
v1.11.1

Other libraries Used
--------------------

openssl 3.5.5
zlib1g 1.3.1
tomlc17 (https://github.com/cktan/tomlc17)

See https://www.libssh2.org for details of the libssh2 library.

Getting Started
---------------

After double clicking the !SecureView application the !SecureView icon appears
on the iconbar.

Clicking 'Select' on the SecureView icon displays the connect window. Fill in the details for the
folder you want to open then click on 'Connect'.
On successfully opening a folder you should see a filer like window appear. To navigate
double-click on a directory to open it. To get back to a previous directory double-click
'^' (You may need to scroll down if there are a lot of files in a folder.) or click menu and select 'Open parent'.
Only single files are uploadable and downloadable at the moment. Click menu over a file and save in the
normal way by dragging the icon to a local folder.
To upload a file drag it in the normal way from a Filer window.
If the file is large an hourglass will appear while it downloads/uploads. The maximum download/upload size is
limited to just under 4GB or less depending on the local file system.

Create Public/Private key Pair
------------------------------

For servers that don't support ed25519

ssh-keygen -f id_rsa

Using puttytools (recommended method)

puttygen -t ed25519 -o private-openssh-new
puttygen ed25519 -O public-openssh -o ed25519.pub

Example config.xml
------------------

[default]
# Ip address of the ssh server
hostname = "192.168.1.100"
# Port number of the ssh server
port = 22
# initial folder path to open
pathname = "/home/username"
# A valid username on the ssh server
user = "username"
# Set to true to enable or false to disable public key authentication
publickey = false
# Download/Upload buffer in bytes
buffersize = 16384

[ssh]
# Public/Private key pair
pubkey = "/<Choices$Dir>/secureview/id_rsa.pub"
privkey = "/<Choices$Dir>/secureview/id_rsa"

History
-------

RISC OS Version 0.01 alpha (30-Oct-22)
- this is the initial alpha release of SecureView.
RISC OS Version 0.02 alpha (05-Nov-22)
- handle path name of / correctly
- add 'Refresh' option to menu
- add 'Open parent' option to menu
- add 'Display' menu option, sort folder by either date or file name
RISC OS Version 0.03 alpha (31-Mar-26)
- can now delete an empty folder
- file time stamps maintained uploading a file
RISC OS Version 0.04 alpha (14-Apr-26)
- add 'Rename' option to menu
- populate default connection settings from config.toml
- Fix corruption when getting the file type name
- add public key authentication
RISC OS Version 0.05 alpha (10-May-26)
- fade relevant menu options depending on where menu was clicked
- can now load password protected private key
- an invalid path displays an error instead of a blank window
- file type is now maintained when uploading a file

Todo
----

Add 'fingerprint' check against known_hosts and UI to prompt if unknown and add new to known_hosts file
Enable recursive delete for folders
Add file/folder delete prompt
Time-based One-Time Password (TOTP) 2FA

Issues
------

Trying to connect to a non-existing server or where port 22 is blocked causes SecureView to hang.

It is the 5th alpha version so there will be bugs and many missing features.

This is the only documentation for the moment. Full documentation will gradually
appear as more features are added/completed.

Only single file downloads and uploads are currently enabled.

Downloads and uploads are single tasking. An hourglass will appear during the download/upload.

The number of files displayed is limited to 999,

If an error happens you may see a blank screen or the screen fails to update. Just close the window and open the folder again.

Files starting with a '/' may not download. Just change the name without a '/'.

Only single files and empty folders can be deleted. Deleting a folder containing files or folders has no effect.

Files are only sorted in case insensitve or date ascending order.

Only entering the IP address in the 'hostname' field works currently.

The config.toml must be created and placed in the Boot:Choices.secureview folder manually. Create the folder secureview first if
it doesn't exist.

When dragging the save box to an application or double-clicking a file nothing happens due to ram transfers not being implemented.

Contact
-------

Chris Gransden - chrisg@riscosports.co.uk

