| Both sides previous revision Previous revision | |
| od_commander [2022/07/12 04:51] – [Controls] controls have been updated atari | od_commander [2024/05/16 16:43] (current) – Lots of improvements lbrpdx |
|---|
| ====== OD Commander ====== | ====== 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). | [[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). |
| * {{: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: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) | * {{: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> | <WRAP center round help> |
| |
| ===== How to use it ===== | ===== 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. | OD commander follows the dual-pane setup popular with power-user oriented file managers such as Norton command and Midnight commander. |
| 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''): | 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> | <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. | 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> | </WRAP> |
| |
| ==== Editing text documents ==== | ==== 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 ===== | ===== Accessing external drives ===== |
| |
| 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. | 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> |
| |