File: README

package info (click to toggle)
positron 1:1.1-2
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 500 kB
  • ctags: 274
  • sloc: python: 2,952; sh: 385; makefile: 51
file content (166 lines) | stat: -rw-r--r-- 5,981 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
positron - Neuros Synchronization Manager for Linux
Version 1.1

Copyright 2003-2004 - Xiph.org Foundation
Written and maintained by Stan Seibert <volsung@xiph.org>

MP3Info.py: Copyright 2002 - Vivake Gupta (vivakeATomniscia.org).  
            All rights reserved.

See COPYING for software license.

---------------------------------------------------------------------

OVERVIEW

Positron is a synchronization tool for the Neuros portable music
player (http://www.neurosaudio.com).  Positron allows you to
individually add and delete tracks from a Neuros, as well as
synchronize it with a directory tree of music.

As far as your computer is concerned, a Neuros is just an external USB
hard disk, following the USB Mass Storage standard.  You can copy
any sort of file, music or otherwise, onto the Neuros.  However, only files
that are listed in a special database stored on the Neuros will be
playable.  This is where positron is needed.  It will both physically
copy files and update the Neuros database so those files are playable.


INSTALLATION

First, you need to install positron on your computer.  You can do this
by installing the binary packages in the usual way:

For RPM-based systems   : rpm -ivh positron*.rpm
For Debian-based systems: 
   Add the following lines to your /etc/apt/sources.list:
      deb http://i.cantcode.com/~jack/debian unstable main contrib
      deb-src http://i.cantcode.com/~jack/debian unstable main contrib

   And type:  apt-get update
              apt-get install positron

For Gentoo systems	: emerge positron

To install from the source tarball, unpack the positron source and 
cd into the resulting directory.  Then run the following commands:

  python setup.py install

You will probably need to become root in order to do this.  If you want to install somewhere other than the default location of /usr you can type:

  python setup.py install --prefix=/some/prefix

or:

  python setup.py install --home=/some/prefix

Please see "Installing Python Modules" at 
http://www.python.org/doc/current/inst/inst.html
for more information on how to use distutils.


CONFIGURING

Next, you will need to configure your system to work with USB Mass
Storage devices.  The work required to do this varies depending upon
your particular distribution, but here are some general hints:

* You need kernel support for USB, USB Mass Storage, and SCSI drives
  either in the kernel or loaded as modules (usbcore, usb-storage,
  scsi_mod, sd_mod).  Some of these may automatically be loaded for you.

* Plug your Neuros into your USB port and wait a moment.  The "dmesg"
  command should show the Neuros being recognized by the USB subsystem
  and the assignment of a SCSI device (like "sda", for example).

* Create a directory to mount your Neuros under, like "/mnt/neuros"

* Now you can edit your /etc/fstab file and add a line like:

/dev/sda1 /mnt/neuros vfat user,noauto,umask=0	0 0

This is assuming that the Neuros was registered as "sda" when it was
discovered by the kernel.  You may have to adjust it.  The Neuros
filesystem, however, is always on partition 1.

* Test your setup by running "mount /mnt/neuros" as a normal user.
  You should be able to go browse around the contents of /mnt/neuros.
  (There will be something there, even if your Neuros is brand new and
  "empty".)

* Finally, run "positron config" while the Neuros is mounted and
  configure your personal settings.


BACKING UP THE DATABASE

Given various bug reports about lockups when doing USB transfers to
the Neuros in Linux, it would be best to back up the Neuros database
before use.  You can do this by copying the entire "WOID_DB" directory
on the Neuros to some safe location.  If you need to restore the
database, just remove the "WOID_DB" directory on the Neuros and copy
your backup copy of the directory in its place.


USAGE

Before using positron, make sure to mount your Neuros.  And when you
are done, remember to unmount it before unplugging it.  Linux buffers
disk writes, and you want to make sure everything gets written to
disk.

Most people will use "positron sync" to copy over all of their music
directories (specified when you ran "positron config").  You can run
this command periodically, and only new tracks will be copied.

If you want to add a specific track, you can use "positron add track.mp3".

More detail on these commands can be found using "positron help".


IN CASE OF EMERGENCY

If for some reason your Neuros seems to be mysteriously locking up, or
your song listing seem incorrect or unusable, you can use "positron
rebuild" to recreate your database based upon the music files already
on the Neuros.  Positron will try to figure out where everything
should be filed, but with the following limitations:

* The pcaudio database will be cleared.
* All HiSi clips will be marked as unidentified, even if they had been
  previously identified.

"My Neuros has locked up, and I am very angry. What now?"
You can reset the unit by pressing and holding the Up and Play buttons
simultaneously.


CONTACT INFO

We strongly encourage bug reports and feature requests.  You can contact
us in one of the following ways:

* To report bugs use Bugzilla at http://bugs.xiph.org. We prefer bug
  reports to be filed this way.  Please file them against the 'positron' 
  product.
* Mailing list: http://www.xiph.org/archives.  Look for the positron list.
* IRC: #positron on irc.freenode.net.  You are also welcome to join 
  #vorbis-talk for general talk about the Xiph.org Foundation projects.
* Email: You may contact the author directly at volsung@xiph.org, but
  please only do this as a last resort.

ACKNOWLEDGEMENTS

Special thanks go out to:

  * Emmett Plant
  * Manuel Lora
  * Jack Moffitt

and most especially:
  * the awesome folks at Digital Innovations, who answered many
    questions, and were willing to open source positron.

Without valuable support from all these people, this software would not have
been possible.