Difference between revisions of "IRiver iFP Audio Players"

From ArchWiki
Jump to: navigation, search
m (add DISPLAYTITLE)
(9 intermediate revisions by 6 users not shown)
Line 1: Line 1:
[[Category:Audio/Video]]
+
[[Category:Other hardware]]
 +
{{DISPLAYTITLE:iRiver iFP Audio Players}}
 +
{{out of date|The kernel modules section might be irrelevant. The udev rules section is out-of-date. Other sections may be out-of-date as well.}}
 
===Description===
 
===Description===
ifp-line lets you manage your iRiver mp3 music player acting in \"Manager Mode\" ONLY.
+
{{Pkg|libifp}}, which provides the {{ic|ifpline}} command, lets you manage your [[Wikipedia:Iriver#Discontinued_2|iRiver]] MP3 music player acting in "Manager Mode" ONLY.
If your player is using \"UMS Mode\", then you don't need this program; it will appear as a new drive when you plug it in.
+
If your player is using "UMS Mode", then you do not need this program; it will appear as a new drive when you plug it in.
At the time of writing, only Manager Mode can play ogg-vorbis format files.
+
At the time of writing, only Manager Mode can play [[Wikipedia:Vorbis|Ogg Vorbis]] format files.
  
ifp can upload or download files or directories, delete or make directories on the device, format the device, or upgrade your firmware.
+
libifp can upload and download files and directories, delete and create directories on the device, format the device, and upgrade your firmware.
It effectively manages most of the tasks performed by the iRiver software provided for windows -whilst being faster & more stable.
+
It effectively manages most of the tasks performed by the iRiver software provided for Windows, while being faster and more stable.
  
It is recommended that it is used in conjunction with Midnight Commander to help manage your music files more effectively.
+
It is recommended that it is used in conjunction with [[Wikipedia:Midnight_Commander|Midnight Commander]] to help manage your music files more effectively.
  
This configuration assumes Udev and hotplug will be used.
+
====Configure needed kernel modules====
  
====Setup udev:====
+
Refer to [[Kernel_modules#Loading]] and make sure the modules {{ic|usbserial}} and {{ic|usb_storage}} are loaded.
  
See [http://wiki2.archlinux.org/index.php/UdevHowTo]
+
====Install iRiver driver/manager software====
  
====Configure usb:====
+
[[pacman|Install]] the {{Pkg|libifp}} package from the [[Official Repositories|official repositories]] and then reboot the system.
  
Edit /etc/rc.conf:
+
====Verify that you can connect to your iRiver device====
  
Add to DAEMONS: 'hotplug'
+
Connect iRiver device to your PC with the supplied USB cable and then run this command:
 
+
  $ ifpline ls /
Add to MODULES: 'usbserial' 'usb-storage'
+
 
+
====Install iRiver driver/manager from extra repository:====
+
 
+
$ pacman -S ifp-line
+
 
+
$ reboot
+
 
+
====Verify that you can connect to your iRiver:====
+
 
+
Connect iRiver device to your pc with the supplied usb cable.
+
 
+
In bash do:
+
  $ ifp ls /
+
  
 
If successful, the output should display the root directory on your iRiver, similar to this:
 
If successful, the output should display the root directory on your iRiver, similar to this:
Line 42: Line 30:
 
  d music
 
  d music
  
====Midnight Commander Setup (as root)====
+
====Midnight Commander setup====
8 Install midnight Commander
+
* [[pacman|Install]] Midnight Commander, provided by the {{Pkg|mc}} package, from the [[Official Repositories|official repositories]].
  $ pacman -S mc
+
  # pacman -S mc
* Copy the ifp binary to the midnight Commander extfs directory
+
* Copy the {{ic|ifpline}} binary to the Midnight Commander extfs directory
  $ cp /usr/bin/ifp /usr/share/mc/extfs/
+
  # cp /usr/bin/ifpline /usr/share/mc/extfs/
* Edit /usr/share/mc/extfs/extfs.ini & add a new line at the bottom:
+
* Edit {{ic|/usr/share/mc/extfs/extfs.ini}} and add a new line at the bottom:
  ifp
+
  ifpline
* Save changes to extfs.ini
+
* Save changes to {{ic|extfs.ini}}
* run midnight commander
+
* Start Midnight Commander, and in its command line, enter:
$ mc
+
  cd /#ifpline
* In Midnight Commanders command line type:
+
  cd /#ifp
+
  
You should now have full access to your iRiver directories via midnight commander.
+
You should now have full access to your iRiver directories via Midnight Commander.
You will be able to copy & delete music tracks as you wish.
+
You will be able to copy and delete music tracks as you wish.
  
 
====Setting up udev to automatically assign permissions====
 
====Setting up udev to automatically assign permissions====
Put the following into a file named ifpdev.rules in /etc/udev/rules.d
+
Put the following into the file {{ic|/etc/udev/rules.d/ifpdev.rules}}:
 +
{{hc|/etc/udev/rules.d/ifpdev.rules|<nowiki>
 
  # udev rules file for supported ifp devices
 
  # udev rules file for supported ifp devices
 
  #
 
  #
Line 89: Line 76:
 
   
 
   
 
  LABEL="libifp_rules_end"
 
  LABEL="libifp_rules_end"
 +
</nowiki>}}
 +
 +
And add the user you want to have permissions to the storage [[Users and Groups|group]]:
 +
# gpasswd -a username storage
  
And add the user you want to have permissions to the storage group
+
===Notes===
gpasswd -a username storage
+
Do not delete the default folders in the {{ic|/}} directory of your iRiver&mdash;it may cause issues!
  
----
+
Midnight Commander, by default, preserves file permissions when copying files. Because these file permissions cannot be written to your iRiver, an error message will be displayed after each file copy. To prevent these messages from appearing, uncheck the "preserve attributes" checkbox on Midnight Commander's copy dialog.
  
===Notes:===
+
If you frequently copy directories to your iRiver rather than individual tracks, then select the directory to copy & check the "Dive into subdir if exists" checkbox.
Do not delete the default folders in the / directory of your iRiver -it may cause issues!<br>
+
Midnight Commander (by default) copies files preserving their file permissions. Because these file permissions cannot be written to your iRiver, an error message will be displayed after each file copy.<br>
+
To prevent these messages from appearing, UNCHECK the 'preserve attributes' checkbox on midnight commanders copy dialog.<br>
+
<br>
+
If you frequently copy directories to your iRiver rather than individual tracks, then select the directory to copy & check the 'Dive into subdir if exists' checkbox.
+
<br>
+
  
The ifp commands can easily be incorporated into your own bash scripts to make the management of your iRiver even faster !
+
The {{ic|ifpline}} commands can easily be incorporated into your own shell scripts to make the management of your iRiver even easier! Run {{ic|ifpline}} for a list of all supported commands.
See the man page for more !
+
  
====Upgrading Firmware====
+
====Upgrading firmware====
#get the firmware for the manager version and name it IFP-3XXT.HEX
+
#Get the firmware for the manager version and name it {{ic|IFP-3XXT.HEX}}
#run ifp firmupdate ./IFP-3XXT.HEX
+
#Run {{ic|ifpline firmupdate ./IFP-3XXT.HEX}}
#wait for player to do its thing, concluding in a poweroff
+
#Wait for the device to update, concluding in a power-off
#unplug everything, turn on player, and plug back in
+
#Unplug everything, turn on the player, and plug it back in
#run ifp ls / to see some files, ensure it is working
+
#Run {{ic|ifpline ls /}} to see some files and ensure it is working
<br>
+

Revision as of 23:04, 21 October 2012


Tango-view-refresh-red.pngThis article or section is out of date.Tango-view-refresh-red.png

Reason: The kernel modules section might be irrelevant. The udev rules section is out-of-date. Other sections may be out-of-date as well. (Discuss in Talk:IRiver iFP Audio Players#)

Description

libifp, which provides the ifpline command, lets you manage your iRiver MP3 music player acting in "Manager Mode" ONLY. If your player is using "UMS Mode", then you do not need this program; it will appear as a new drive when you plug it in. At the time of writing, only Manager Mode can play Ogg Vorbis format files.

libifp can upload and download files and directories, delete and create directories on the device, format the device, and upgrade your firmware. It effectively manages most of the tasks performed by the iRiver software provided for Windows, while being faster and more stable.

It is recommended that it is used in conjunction with Midnight Commander to help manage your music files more effectively.

Configure needed kernel modules

Refer to Kernel_modules#Loading and make sure the modules usbserial and usb_storage are loaded.

Install iRiver driver/manager software

Install the libifp package from the official repositories and then reboot the system.

Verify that you can connect to your iRiver device

Connect iRiver device to your PC with the supplied USB cable and then run this command:

$ ifpline ls /

If successful, the output should display the root directory on your iRiver, similar to this:

d VOICE
d RECORD
d music

Midnight Commander setup

# pacman -S mc
  • Copy the ifpline binary to the Midnight Commander extfs directory
# cp /usr/bin/ifpline /usr/share/mc/extfs/
  • Edit /usr/share/mc/extfs/extfs.ini and add a new line at the bottom:
ifpline
  • Save changes to extfs.ini
  • Start Midnight Commander, and in its command line, enter:
cd /#ifpline

You should now have full access to your iRiver directories via Midnight Commander. You will be able to copy and delete music tracks as you wish.

Setting up udev to automatically assign permissions

Put the following into the file /etc/udev/rules.d/ifpdev.rules:

/etc/udev/rules.d/ifpdev.rules
 # udev rules file for supported ifp devices
 #
 # To add an USB ifp device, add a rule to the list below between the SUBSYSTEM...
 # and LABEL... lines.
 #
 # To run a script when your ifp is plugged in, add RUN="/path/to/script"
 # to the appropriate rule.
 #
 
 SUBSYSTEM!="usb_device", ACTION!="add", GOTO="libifp_rules_end"
 
 # ifp-1xx
 SYSFS{idVendor}=="4102", SYSFS{idProduct}=="1001", GROUP="storage"
 # ifp-3xx
 SYSFS{idVendor}=="4102", SYSFS{idProduct}=="1003", GROUP="storage"
 # ifp-5xx
 SYSFS{idVendor}=="4102", SYSFS{idProduct}=="1005", GROUP="storage"
 # ifp-7xx
 SYSFS{idVendor}=="4102", SYSFS{idProduct}=="1007", GROUP="storage"
 # ifp-8xx
 SYSFS{idVendor}=="4102", SYSFS{idProduct}=="1008", GROUP="storage"
 # ifp-9xx
 SYSFS{idVendor}=="4102", SYSFS{idProduct}=="1009", GROUP="storage"
 # ifpdev
 SYSFS{idVendor}=="4102", SYSFS{idProduct}=="1010", GROUP="storage"
 # The N10
 SYSFS{idVendor}=="4102", SYSFS{idProduct}=="1011", GROUP="storage"
 
 LABEL="libifp_rules_end"

And add the user you want to have permissions to the storage group:

# gpasswd -a username storage

Notes

Do not delete the default folders in the / directory of your iRiver—it may cause issues!

Midnight Commander, by default, preserves file permissions when copying files. Because these file permissions cannot be written to your iRiver, an error message will be displayed after each file copy. To prevent these messages from appearing, uncheck the "preserve attributes" checkbox on Midnight Commander's copy dialog.

If you frequently copy directories to your iRiver rather than individual tracks, then select the directory to copy & check the "Dive into subdir if exists" checkbox.

The ifpline commands can easily be incorporated into your own shell scripts to make the management of your iRiver even easier! Run ifpline for a list of all supported commands.

Upgrading firmware

  1. Get the firmware for the manager version and name it IFP-3XXT.HEX
  2. Run ifpline firmupdate ./IFP-3XXT.HEX
  3. Wait for the device to update, concluding in a power-off
  4. Unplug everything, turn on the player, and plug it back in
  5. Run ifpline ls / to see some files and ensure it is working