Differences

This shows you the differences between two versions of the page.

--- od_commander [2022/06/30 07:09] – what do if delete od commander atari
+++ od_commander [2024/05/16 16:43] (current) – Lots of improvements lbrpdx
@@ Line 1: / Line 1: @@
 ====== OD Commander ======
-<WRAP center round todo>
-Under construction.
-</WRAP>
 [[https://github.com/glebm/od-commander|OD commander]] is a fork of [[https://github.com/jbanes/rs97-commander|DinguxCommander]] which is a gamepad-oriented file manager (if you have used some of the weaker SBC handhelds that run Dingoo you may already be familiar with the software). It follows the "x commander" philosophy of having the left panel show the "source" and the right panel show the "destination", similar to Midnight Commander (which is also already included in Batocera).
@@ Line 10: / Line 7: @@
 ===== Controls =====
-<WRAP center round help>
-Controls are tentative.
-</WRAP>
 Gamepad control (equivalent keyboard key):
@@ Line 19: / Line 12: @@
   * D-pad (Arrow keys) - Move
   * ''[L1]''/''[R1]'' (Page Up/Page Down) - Page up/page down
-  * {{:wiki:east.png?nolink&20|East button (A SNES)}} (Enter) - Select (on a directory: open, on a file: view or execute)
+  * {{:wiki:south.png?nolink&20|South button (B SNES)}} (Enter) - Select (on a directory: open, on a file: view or execute)
-  * {{:wiki:south.png?nolink&20|South button (B SNES)}} (Backspace) - Go to parent directory/cancel
+  * {{:wiki:east.png?nolink&20|East button (A SNES)}} (Backspace) - Go to parent directory/cancel
   * {{:wiki:west.png?nolink&20|West button (Y SNES)}} (Esc) - File menu (Available actions: Select all items, Select no items, Create new directory, Display disk information, Quit program)
   * {{:wiki:north.png?nolink&20|North button (X SNES)}} (Space) - Context menu (Available actions: Copy to other panel directory, Move to other panel directory, Rename, Delete, Display disk used)
-  * ''[SELECT]'' (FIXME) - Select highlighted item (selected items are displayed in red)
+  * ''[SELECT]'' - Select highlighted item so that you can do the same action on multiple items (like if you want to delete multiple files). Selected items are displayed in red, click ''[SELECT]'' again to unselect them.
-  * ''[START]'' (FIXME) - Open directory in the destination panel (if a file is highlighted, open current directory in the destination panel instead)
+  * ''[START]'' - Open directory in the destination panel (if a directory is highlighted, open current directory in the destination panel and show the files in it).
+  * ''[Hotkey]''+''[START]'' - Quit
+<WRAP center round help>
+In Batocera **v34**, {{:wiki:south.png?nolink&20|South button (B SNES)}} and {{:wiki:east.png?nolink&20|East button (A SNES)}} are reversed.
+</WRAP>
 <WRAP center round tip>
@@ Line 31: / Line 29: @@
 ===== How to use it =====
-<WRAP center round todo>
-Stuff about how this is different from ordinary file managers that use separate instances, focus on the philosophy of dual-pane, etc.
-Include another hint on how to Quit the program when done.
-</WRAP>
 OD commander follows the dual-pane setup popular with power-user oriented file managers such as Norton command and Midnight commander.
@@ Line 44: / Line 36: @@
 Press the {{:wiki:north.png?nolink&20|North button (X SNES)}} button to bring up the context menu. Any action here that would perform the operation into the directory in the other pane is indicated by a ''>'' or a ''<'' character, showing which "direction" the operation will take place in. For example, this will copy the file from the right pane (''path/to/right'') into the left pane (''path/to/left''):
-FIXME (add image/video showing that here)
+{{ :emulators:odcommander-context.png?600 |}}
 <WRAP center round tip>
 It's useful to check your remaining free space from time to time as you're copying files around. Press {{:wiki:west.png?nolink&20|West button (Y SNES)}} and then go to **Disk info** to see the current amount of used space compared to the total available.
-FIXME (image here showing tooltip)
 </WRAP>
 ==== Editing text documents ====
-OD commander has a built-in text editing software.
+OD commander has a built-in text editing software. For example, if you open ''batocera.conf'', you can edit it from ODCommander.
-<WRAP center round todo>
+Move to the line you want to edit with the joypad and click {{:wiki:south.png?nolink&20|South button}} to open a contextual menu that will let you edit a line, duplicate it, insert a line before/after or remove the line. Then, if you edit a line, you will have access to an on-screen keyboard that can be used with the joypad or the touchscreen if your device supports it.
-Apparently there's also an on-screen keyboard? Can you also use keyboard? Investigate.
-</WRAP>
+{{ :emulators:odcommander-edit.png?600 |}}
 ===== Accessing external drives =====
@@ Line 75: / Line 66: @@
 If you'd like to regenerate it back, simply delete the ''/userdata/roms/odcommander'' folder and reboot Batocera. It will be recreated along with its gamelist on next boot.
+===== The fonts/icons are too small/too large! =====
+Sometimes the icons and text in OD Commander are not optimal for your device/resolution, in particular when you use Batocera on a handheld device, or connected to a screen with a non standard resolution. They might be either too small or too large to be readable.
+To fix it, you can [[access_the_batocera_via_ssh|connect to Batocera through SSH]] or through the SMB network and create or edit the configuration file ''/userdata/system/.config/commander.cfg'' and add the parameters in the following paragraph. This is an example for a SteamDeck (LCD version):
+<code>
+disp_autoscale_dpi=0
+disp_width=800
+disp_height=1280
+disp_ppu_x=2
+disp_ppu_y=2
+</code>