Linux Commands Examples

A great documentation place for Linux commands


p VisioBraille file transferring


vstpg [-ifbnd] [-s socketport] [-k keyname] [-o configname] file ...

add an example, a script, a trick and tips

: email address (won't be displayed)
: name

Step 2

Thanks for this example ! - It will be moderated and published shortly.

Feel free to post other examples
Oops ! There is a tiny cockup. A damn 404 cockup. Please contact the loosy team who maintains and develops this wonderful site by clicking in the mighty feedback button on the side of the page. Say what happened. Thanks!


no example yet ...

... Feel free to add your own example above to help other Linux-lovers !


vstpg (resp. vstpp) gets (resp. puts) files from (resp. onto) a VisioBraille terminal.

For communicating with the terminal, you must launch brltty with the BrlNet driver, and telling BrlNet to use the VisioBraille driver.

Before putting on the terminal, file names are truncated to 8 characters without any extension.

Before getting from terminal, leading path and trailing extensions are removed, but put back for local filename.

command line options


ask for confirmation of transfer, for each file (on the terminal)


don’t ask for such a confirmation (default)


if they exists, recursively rename the old files with an added .x suffix, just like logrotate does


do not keep such backup file (default)

-s socketport

use socketport as the port number instead of default for connecting to BrlNet

-k filename

use filename as key path instead of default for reading BrlNet’s authentication key


use current directory rather than the download directory (see vbs_dir below)

-o filename

also read filename as config file

config file

vstpg and vstpp read a configuration file $HOME/.vstprc which contains keywords or equalities, one per line (what follows a # is ignored).

You can ask them to also read any other file thanks to the -o option.

Here are keywords:


make -b option the default


make -f option the default

and equalities:
= filename

use this file instead of default, to find BrlNet’s authentication key

socketport = port

use this port number, instead of default, to connect to BrlNet

vbs_ext = .ext

use .ext as an extension for downloaded files (.vis by default) this is overriden on command line if an extension is provided in the file name

vbs_dir = path

use path instead of current directory for putting files, except when using the -d option, or if the filename begins with ’.’

returned value

Image grohtml-85211.png

shell expansions

Beware of special chars: * and . are often expanded by your shell, hence vstpp * will probably do what you want, putting every file existing in the current directory onto the terminal, but vstpg * may not do what you want: it will only get every file which already exist in the current directory, skipping those you just created on your terminal ! If you want to get every file which exist in the terminal, you should use vstpg ’*’ or something similar (please read your shell manual).

The same warning applies to other special chars, such as $, ~, &,... which should be protected by surrounding arguments by quotes (’) or by using single backslashes (\) just before them (please read your shell manual).


The one we could find has been corrected :)


Samuel Thibault <> and Sebastien Hinderer <>

How can this site be more helpful to YOU ?

give  feedback