positron(1) · carta

NAME

positron - Neuros Synchronization Manager for Linux

SYNOPSIS

positron [ add file(s) ] [ sync ] [ sync --reset-deleted ] [ sync --reset-recordings ] [ del file(s) ] [ config ] [ rebuild ] [ list ] [ clear ] [ pack ] [ addtopl playlist file(s) ] [ editpl playlist ] [ delpl playlist ] [ help command ] [ -m mountpoint ] [ -c directory ]

DESCRIPTION

positron is a synchronization tool for the Neuros portable music player.

COMMAND SUMMARY

add: Adds files to the Neuros databases, copying as necessary

sync: Synchronizes your Neuros with your music library

del: Removes files from the database and disk

config: Create or modify the current configuration

rebuild: Recreates the positron databases

list: Lists files in the database

clear: Clears all entries from databases without removing any files

pack: Removes unused space from databases

addtopl: Add files to playlist

editpl: Edit contents of playlist

delpl: Delete playlist

-m: Specify a mountpoint

-c: Specify an alternate config directory

COMMAND DETAIL

positron sync

Copies any new music tracks from the directories specified in the configuration file to the Neuros. It also copies new FM or microphone recordings from the Neuros to your computer. Positron remembers which tracks have been removed with positron del and will not add them again when you sync.

positron sync --reset-deleted

Clears the list of deleted files.

positron sync --reset-recordings

Clears the list of already-transferred recordings.

positron add <sourcefile> <targetfile>

Copies sourcefile to targetfile (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.

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.

positron del [files or directories]

Deletes a list of files and/or directories on the Neuros itself (ex: /mnt/neuros/music/rock) to be removed. Both the file on disk and the database entries are deleted.

Only files referenced in the database will be removed, as well as empty directories.

positron addtopl <playlist> <neurosfile1> <neurosfile2> ...

Add files to playlist, in order, creating the playlist if necessary. The files are those on the Neuros.

positron editpl <playlist>

Invoke editor to allow you to move or remove files from the playlist.

positron delpl <playlist>

Delete the specified playlist.

positron config

Asks several questions and creates a new configuration set. Also allows the current configuration to be edited.

positron rebuild

Rebuilds all the databases from scratch. Positron will locate all of the music files already on the Neuros and put their entries back into your databse as best as it can guess. The database of music stored on your computer ("pcaudio") is cleared and all HiSi clips will be marked as unidentified.

positron list

List files in the audio database.

positron list <database1> <database2> ...

Lists all entries from a particular database. Valid database names are: audio, pcaudio, unidedhisi, idedhisi, failedhisi.

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.

The clear command never removes files.

BUGS

The playlist commands are very basic and not well integrated. In particular, doing a positron rebuild will lose all your playlists.

AUTHORS

Program Author:: Stan Seibert <[email protected]>

Manpage Author:: Manuel Lora <[email protected]>