Positron User's Guide: Command Reference

General

The general syntax for positron is:

positron [-c config_dir] [-m mountpoint] [command] [command arguments]
-m mountpoint, --mount-point=mountpoint
The directory where the Neuros is mounted. This overrides whatever is stored in the configuration file.
-c config_dir, --config=config_dir
The directory where the positron configuration is stored. By default this is ~/.positron.
The commands are described below.

add

Adds files to the Neuros database, copying as necessary. Files that are already on the Neuros will not be overwritten, but just added to the database if not already present. Non-music files are ignored.

Usage

positron add [sourcefile] [targetfile]
Copies sourcefile to targetfile (a path on the Neuros that does not exist)
positron add [sourcefile1] [sourcefile2] ... [targetdir]
Copies sourcefiles to targetdir (a directory on the Neuros that already exists)
positron add [sourcefile1] [sourcefile2] ...
Copies sourcefiles to the default music directory. Copy directories to the default music directory the same way.

del

Removes files both from the Neuros database and from the Neuros filesystem. Positron will only delete files that have database entries, and will remove directories only if they are empty. Positron remembers which files have been deleted using this command, and will not recopy them during synchronization. Deleted files can be recopied using the add command. The list of deleted files can also be purged using the --reset-deleted option to the sync command.

Usage

positron del [files or directories]
Searches a list of files and/or directories on the Neuros itself (ex: /mnt/neuros/music/rock) to be removed. Directories will be recursively searched for music files to delete.

clear

Clears all entries from the databases. This does not remove any files, however.

Usage

positron clear
Clears all databases.
positron clear [database1] [database2] ...
Clears all entries from a particular database. Valid database names are: audio, pcaudio, unidedhisi, idedhisi, failedhisi

config

Creates or modifies the current configuration interactively. Positron will ask you a series of questions and create a configuration files based upon your answers. If you already have a configuration, those options will be the default answers. See the configuration guide for more information.

help

Displays help information about positron commands.

Usage

positron help
Shows general help about positron and a brief listing of commands.
positron help [command]
Displays detailed help about a specific command.

list

Lists all of the entries in a database. Only listing the audio database is supported at this time.

Usage

positron list
Lists entries in the audio database
positron list [database1] [database2] ...
List all entries from a particular database. Valid database names are: audio, pcaudio, unidedhisi, idedhisi, failedhisi

pack

Removes unused space from databases. This is created when entries are deleted from the database. Note that packing is automatically done whenever you synchronize with positron, so you should seldom need to do this manually.

Usage

positron pack
Packs all databases.
positron pack [database1] [database2] ...
Packs all entries from a particular database. Valid database names are: audio, pcaudio, unidedhisi, idedhisi, failedhisi

rebuild

Recreates the Positron databases from the music tracks found on the Neuros. This command completed wipes the Neuros databases and rebuilds them from scratch. It is needed if your databases have become corrupted. Positron will locate all of the music files already on the Neuros and put their entries back into the database as best as it can guess. The database of music stored on your computer ("pcaudio") will cleared and all HiSi clips will be marked as unidentified even if they had been previously identified.

Usage

positron rebuild
Rebuilds all of the databases.
sync

Synchronizes your Neuros with your music library. This will scan all of the syncpoints specified during configuration for new files and copy them to your Neuros. It also scans your Neuros for new FM, microphone or line-in recordings and copies them to your, if you specified a location for them during configuration.

Positron remembers which files have been removed with positron del and which recordings have already been copied to the computer. They will not be recopied. You can clear these lists with the options shown below.

Usage

positron sync
Synchronizes Neuros with your computer.
positron sync --reset-deleted
Clears the list of deleted tracks. This does not perform synchronization. Rerun sync without options to synchronize.
positron sync --reset-recordings
Clears the list of recordings that have already been copied to the computer. This does not perform synchronization. Rerun sync without options to synchronize.