---
name: "positron"
section: "1"
platform: "linux"
package: "positron"
version: "1:1.1-2"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/positron"
---

# positron(1)

Neuros Synchronization Manager for Linux

## 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 \<volsung@xiph.org\>

- Manpage Author:

  Manuel Lora \<vanguardist@xiph.org\>

## SEE ALSO

Move along, nothing to see here. - Officer Barbrady