Foobar2000:File Operations (foo fileops): Difference between revisions

From Hydrogenaudio Knowledgebase
(First draft)
 
mNo edit summary
 
(19 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{fb2k}}
{{infobox foobar2000 component
| name                = File Operations
| screenshot          =
| caption              =
| module_name          = foo_fileops
| developer            = Peter Pawlowski
| repository          =
| released            =
| released_ref        =
| stable_release      = 1.6.16
| stable_release_date  = 2023-01-13
| preview_release      = 2.0 beta26
| preview_release_date = 2022-02-27
| foobar2000_minimum  =
| foobar2000_maximum  =
| foobar2000_ui_module =
| use                  =
| license              =
}}


The file operations dialog box allows you to copy, move, rename, and delete files from within foobar2000. The key benefits of using the file operations component (as opposed to using Windows Explorer) are:
The '''File Operations''' dialog box, accessible via right click context menu in playlist view, allows you to copy, move, rename, and delete files from within foobar2000. The key benefits of using the file operations component (as opposed to using Windows Explorer) are:
* Based on title formatting.
* Based on [[Foobar2000:Title_Formatting_Reference |title formatting]].
* The Media Library and playlists are automatically updated to reflect the change.
* The Media Library and playlists are automatically updated to reflect the change.
* Data from the [[Foobar2000:Components_0.9/Playback_Statistics_(foo_playcount)|official playback statistics component]] is preserved when moving files.
* Data from the [[Foobar2000:Components/Playback Statistics v3.x (foo playcount)|official playback statistics component]] is preserved when moving files.
** Note: If the files are moved to a folder which is not monitored by the Media Library, they will be removed from the Media Library and playback statistics will also be lost.
** Note: If the files are moved to a folder which is not monitored by the Media Library, they will be removed from the Media Library and playback statistics will also be lost.


=Usage=
==Usage==
The optional component <tt>foo_fileops</tt> is required. To install this component, run the foobar2000 installer and check Optional features > Tools > File Operations. Once installed, you can select a group of tracks in the playlist and File Operations will appear in the context menu.
 
[[Image:Foobar-Fileops-1.png]]
 
* '''Operation''': Copy, rename, or move the files. Note that some options below will be disabled depending on the selected operation.
* '''Operation''': Copy, rename, or move the files. Note that some options below will be disabled depending on the selected operation.
* '''Presets''': See below.
* '''Presets''': See below.
* '''Destination Folder''': The root destination folder. You cannot use title formatting in this field, and the folder must already exist.
* '''Destination Folder''': The root destination folder. You cannot use title formatting in this field, and the folder must already exist.
* '''File Name Pattern''': Specify how the files will be named, and indicate any subfolders (separated by '\'). Title formatting is allowed in this field, and any subfolder which does not exist will be created under the destination folder. The '...' button allows you to select from a set of preset patterns.
* '''File Name Pattern''': Specify how the files will be named, and indicate any subfolders (separated by '\'). Title formatting is allowed in this field, and any subfolder which does not exist will be created under the destination folder. The {{button|...}} button allows you to select from a set of preset patterns.  


* '''Options''':
* '''Options''':
Line 23: Line 37:
* '''Preview''': Shows the potential results of the file operation.
* '''Preview''': Shows the potential results of the file operation.


===Presets===
Presets allow you to save the current settings in the File Operations Setup dialog. Once a preset is created, it is not only accessible from the setup dialog, but from the context menu under File Operations. The latter opens a preview/confirmation dialog (shown above), and you can access the detailed setup menu with the 'More...' button.


==Presets==
===Usage tips===
Presets allow you to save the current settings in the File Operations Setup dialog. Once a preset is created, it is not only accessible from the setup dialog, but from the context menu under File Operations. The latter opens a preview/confirmation dialog, and you can access the detailed setup menu with the 'More...' button.
* Beginning in 0.9.6.4, symbols which are invalid in folder and file names such as '''/ \ |:''' get replaced by a '''-''', '''*''' gets replaced by '''x''', '''&quot;''' gets replaced with '''&#039;&#039;''', and '''? < >''' get replaced by an '''_'''.
 
* You may want to consider using <code>$ascii()</code> or <code>$ansi()</code> to sanitize the names when applying file operations.
[[Image:Foobar-Fileops-2.png]]


==Gallery==
<gallery>
Foobar-Fileops-1.png|File Operations Setup window
Foobar-Fileops-2.png|File Operations Preview window
File_Name_Pattern_Selector.png|File Name Pattern Selector window
foo_fileops_advanced_preferences.png|Advanced preferences page
</gallery>


==Usage Tips==
__NOTOC__
* Symbols which are invalid in folder and file names such as '?' are replaced by '_'.
* You may want to consider using <tt>$ascii()</tt> or <tt>$ansi()</tt> to sanitize the names when applying file operations.

Latest revision as of 17:40, 5 March 2023

File Operations

foo_fileops
Developer(s) Peter Pawlowski
Repository
Release information
Initial release
Stable release 1.6.16 (January 13, 2023)
Preview release 2.0 beta26 (February 27, 2022)
foobar2000 compatibility
Architecture {{{foobar2000_architecture}}}
Minimum version TBC
Maximum version
UI module(s) N/A
Additional information
Use
License
Discussion thread {{{discussion_thread}}}
View all components

The File Operations dialog box, accessible via right click context menu in playlist view, allows you to copy, move, rename, and delete files from within foobar2000. The key benefits of using the file operations component (as opposed to using Windows Explorer) are:

  • Based on title formatting.
  • The Media Library and playlists are automatically updated to reflect the change.
  • Data from the official playback statistics component is preserved when moving files.
    • Note: If the files are moved to a folder which is not monitored by the Media Library, they will be removed from the Media Library and playback statistics will also be lost.

Usage

  • Operation: Copy, rename, or move the files. Note that some options below will be disabled depending on the selected operation.
  • Presets: See below.
  • Destination Folder: The root destination folder. You cannot use title formatting in this field, and the folder must already exist.
  • File Name Pattern: Specify how the files will be named, and indicate any subfolders (separated by '\'). Title formatting is allowed in this field, and any subfolder which does not exist will be created under the destination folder. The ... button allows you to select from a set of preset patterns.
  • Options:
    • Copy/Move Entire Source Folder Content: Useful when you have supplementary files such as cover art in the music folder.
    • Remove Empty Source Folders
  • Preview: Shows the potential results of the file operation.

Presets

Presets allow you to save the current settings in the File Operations Setup dialog. Once a preset is created, it is not only accessible from the setup dialog, but from the context menu under File Operations. The latter opens a preview/confirmation dialog (shown above), and you can access the detailed setup menu with the 'More...' button.

Usage tips

  • Beginning in 0.9.6.4, symbols which are invalid in folder and file names such as / \ |: get replaced by a -, * gets replaced by x, " gets replaced with '', and ? < > get replaced by an _.
  • You may want to consider using $ascii() or $ansi() to sanitize the names when applying file operations.

Gallery