Difference between revisions of "IRiver iFP Audio Players"

From ArchWiki
Jump to: navigation, search
m
m
(10 intermediate revisions by 6 users not shown)
Line 1: Line 1:
[[Category:Other hardware (English)]]
+
[[Category:Other hardware]]
[[Category:HOWTOs (English)]]
+
{{DISPLAYTITLE:iRiver iFP Audio Players}}
===Description===
+
{{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.}}
ifp-line lets you manage your 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.
+
At the time of writing, only Manager Mode can play 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.
+
=== Description ===
It effectively manages most of the tasks performed by the iRiver software provided for windows -whilst being faster & more stable.
+
  
It is recommended that it is used in conjunction with Midnight Commander to help manage your music files more effectively.
+
{{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 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 [[Wikipedia:Vorbis|Ogg Vorbis]] format files.
  
This configuration assumes Udev and hotplug will be used.
+
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.
  
====Setup udev:====
+
It is recommended that it is used in conjunction with [[Wikipedia:Midnight_Commander|Midnight Commander]] to help manage your music files more effectively.
  
See [http://wiki2.archlinux.org/index.php/UdevHowTo]
+
==== Configure needed kernel modules ====
  
====Configure usb:====
+
Refer to [[Kernel_modules#Loading]] and make sure the modules {{ic|usbserial}} and {{ic|usb_storage}} are loaded.
  
Edit /etc/rc.conf:
+
==== Install iRiver driver/manager software ====
  
Add to DAEMONS: 'hotplug'
+
[[pacman|Install]] the {{Pkg|libifp}} package from the [[Official Repositories|official repositories]] and then reboot the system.
  
Add to MODULES: 'usbserial' 'usb-storage'
+
==== Verify that you can connect to your iRiver device ====
  
====Install iRiver driver/manager from extra repository:====
+
Connect iRiver device to your PC with the supplied USB cable and then run this command:
 
+
  $ ifpline ls /
$ 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 43: Line 32:
 
  d music
 
  d music
  
====Midnight Commander Setup (as root)====
+
==== Midnight Commander setup ====
8 Install midnight Commander
+
$ pacman -S mc
+
* Copy the ifp binary to the midnight Commander extfs directory
+
$ cp /usr/bin/ifp /usr/share/mc/extfs/
+
* Edit /usr/share/mc/extfs/extfs.ini  & add a new line at the bottom:
+
ifp
+
* Save changes to extfs.ini
+
* run midnight commander
+
$ mc
+
* In Midnight Commanders command line type:
+
cd /#ifp
+
  
You should now have full access to your iRiver directories via midnight commander.
+
* [[pacman|Install]] Midnight Commander, provided by the {{Pkg|mc}} package, from the [[Official Repositories|official repositories]].
You will be able to copy & delete music tracks as you wish.
+
* Copy the {{ic|ifpline}} binary to the Midnight Commander extfs directory
 +
# cp /usr/bin/ifpline /usr/share/mc/extfs/
 +
* Edit {{ic|/usr/share/mc/extfs/extfs.ini}} and add a new line at the bottom:
 +
ifpline
 +
* Save changes to {{ic|extfs.ini}}
 +
* Start Midnight Commander, and in its command line, enter:
 +
cd /#ifpline
  
====Setting up udev to automatically assign permissions====
+
You should now have full access to your iRiver directories via Midnight Commander.
Put the following into a file named ifpdev.rules in /etc/udev/rules.d
+
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 {{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 90: Line 79:
 
   
 
   
 
  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
 +
 +
=== Notes ===
 +
 +
Do not delete the default folders in the {{ic|/}} directory of your iRiver&mdash;it may cause issues!
  
And add the user you want to have permissions to the storage group
+
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.
gpasswd -a username storage
+
  
----
+
If you frequently copy directories to your iRiver rather than individual tracks, then select the directory to copy and check the "Dive into subdir if exists" checkbox.
  
===Notes:===
+
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.
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 !
+
==== Upgrading firmware ====
See the man page for more !
+
  
====Upgrading Firmware====
+
# Get the firmware for the manager version and name it {{ic|IFP-3XXT.HEX}}.
#get the firmware for the manager version and name it IFP-3XXT.HEX
+
# Run {{ic|ifpline firmupdate ./IFP-3XXT.HEX}}.
#run ifp firmupdate ./IFP-3XXT.HEX
+
# Wait for the device to update, concluding in a power-off.
#wait for player to do its thing, concluding in a poweroff
+
# Unplug everything, turn on the player, and plug it back in.
#unplug everything, turn on player, and plug back in
+
# Run {{ic|ifpline ls /}} to see some files and ensure it is working.
#run ifp ls / to see some files, ensure it is working
+
<br>
+

Revision as of 11:48, 4 June 2013


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

  • Install Midnight Commander, provided by the mc package, from the official repositories.
  • 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 and 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.