User Folders/Bins

Creating folders that are more specific to a particular project is helpful in better organizing your work. This can be done by utilizing the files already loaded to the master Media or Clips folders in the Resources window. The general rule is you can only drag clips to a ClipUserBin and you can only drag media to a MediaUserBin.

Below are steps illustrating an easy way to set up a folder.

In the Resources window (figure 2.26), in the location of the Video/Audio effects and Media folders, bring up the Folder... popup by clicking the right mouse button. Highlight, then click New Media or Clips.

Figure: Highlight, then click “New Media or Clips”. “Modify folder” can be used to change the name of a folder. “Delete folder” in the popup can be used to delete a folder.

Figure 2.27: Type in your folder name in the textbox. Click OK.
In the New folder popup as shown below (figure 2.27), type in your folder name in the textbox. Click OK.

Figure: The “master” Media folder
Select the master Media folder to see which files are currently loaded, figure 2.28. Highlight the files there that you want to copy to your new folder (named Photos of Garden). Drag the files to the left and when you see the Photos of Garden folder become highlighted, then drop there. You can drag and drop any of the media from the master Media at any time. It flashes when the drop is successful.

Adding the Shift key before the actual drop, will allow for relative path filenames instead of full path. But you might want to include or eliminate some of the media that exists in one of the folders that you have set up already. In this case you will want to click on the Modify folder in the popup. When you bring up the Modify folder window, if you already have files in that folder, you will see filters that were generated automatically when you did a Drag and Drop.

**Figure 2.29:** Modify target
$\begin{tikzpicture}[scale=1, transform shape] \node (img1) [yshift=0cm, xshift=... ...ne width=1mm] (Arrow1) edge ([yshift=-20mm] img1.north west); \end{tikzpicture}$

To delete the entire set of files listed on the filter rule, highlight the rule line and hit the Del button. To add a new filter rule, click on the Add button which will automatically add a default line after any current lines. The default line will be a line that matches everything in the master Media folder which is Or Patterns Matches *. Click the right mouse button on the current field underneath the column header to see the choices available for each column.

Modifications will not be in effect until you click on the green arrow OK button or click on the Apply button. But once you hit Apply, clicking on the red X button will not undo your changes. The filter/search rules are applied in the order listed in the Modify folder window. You can change the order of the filter rules by highlighting the rule you want to move and then drag and drop to a new location.

The figure 2.30 below displays the available choices for each field.

**Figure 2.30:** The available choices for each field
$\begin{tikzpicture}[scale=1, transform shape] \node (img1) [yshift=0cm, xshift=... ...){\includegraphics[width=0.5\linewidth]{modify_folder3.png}}; \end{tikzpicture}$

Information about the columns and rules for the search filters in the Modify folder window follows .

Column headers:

Enable

this column is used to designate the state of that filter rule

Off: disable the filter
And: narrow your search; all of your search terms must be present
Or: broaden your search to include more values
And Not: exclude terms that do not contain the given value from your search results
Or Not: include terms that do not contain the given value from your search results

Target

– this column designates which media asset attribute to look at

Patterns: each line contains a filename filter, matches the file path
Filesize: number of bytes in a file
Time: date file was created
Track Type: track type of video, audio, or audio video (for both)
Width: Format width
Height: Format height
Framerate: Video framerate
Samplerate: Audio samplerate
Channels: Number of audio channels
Duration: Playback time in seconds – it uses the largest of audio or video if contains both

Op

– boolean operators used to narrow or broaden the relationship between your search terms

Around: about this value; use +radius for a search range: [target–radius... target+radius]
Eq: equal to
Ge: greater than or equal to
Gt: greater than
Ne: not equal
Le: less than or equal
Lt: less than
Matches: exactly matches for strings

Value — the characteristic you are looking for with expressions that can be written with the following:

Number

(decimal points are allowed and will be converted to a standard form):

inf: representing infinity
#[TtGgMmKk]: — where # represents a number and the characters mean:

inf = infinity

T = 1099511627776

t = 1000000000000

G = 1073741824

g = 1000000000

M = 1048576

m = 1000000

K = 1024

k = 1000

Scalar:

Number

Number+Number

Date time:

date	=	year/month
date	=	year/month/day
time	=	hour:minute
time	=	hour:minute:second
date_time	=	date time

Duration:

day	=	#day \| #days
week	=	#week \| #weeks
month	=	#month \| #months
year	=	#year \| #years
delta	=	secs
delta	=	mins:secs
delta	=	hours:mins:secs

Around time:

date time+duration

Around length:

duration+duration

Table showing the allowed usage:

target: | eq ge gt ne le lt matches around ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ patterns | <---- strcmp ---------> + filter + nearest file_size | <---- arithmetic -------+------> + radius mod_time | <---- arithmetic -------+------> + radius track_type | <---- member test ------+--------+------> width | <---- arithmetic -------+------> + radius height | <---- arithmetic -------+------> + radius framerate | <---- arithmetic -------+------> + radius samplerate | <---- arithmetic -------+------> + radius channels | <---- arithmetic -------+------> + radius duration | <---- arithmetic -------+------> + radius

where in the above, the filter can be:

filter = list

filter = token

list = [token]

list = [token]list

string = <chars>|<empty>

token = string

token = string*token

Examples with some caveats first:

Or generally includes or adds whereas And generally excludes or subtracts.
The filters only work on media in the folder; if there is no media, then there is nothing to search.
The examples below are not meant to be executed as a list of filters in Modify folder, they are just single line examples to indicate what can work.
Sort is by filename base name (directory path not included automatically) except when the Around operation is used and then it is sorted by that Target distance first and then filename.

**Table 2.1:** Examples
Enable	Target	Op	Value	meaning
Or	Patterns	Matches	*	all files from the Media folder are included
And Not	Filesize	Lt	160000000	no files that are less than 160MB in size
Or Not	Time	Ge	2018/07/30 06:13:00	files not greater than or equal date
And	Duration	Eq	01:00	files included must have 60 secs. Duration
Off	Samplerate	Ne	44000	off for now, but may want to include later
And	Framerate	Around	24+1	files included all have 24 to 25 framerate
Or	Patterns	Matches	[*.mp4]	all files with the extension of mp4
Or	Time	Around	2018/08/02 06:00:00 + 02:00:00	files at 4AM to 8 AM

The CINELERRA-GG Community, 2021
https://www.cinelerra-gg.org

inf	=	infinity
T	=	1099511627776
t	=	1000000000000
G	=	1073741824
g	=	1000000000
M	=	1048576
m	=	1000000
K	=	1024
k	=	1000

filter	=	list
filter	=	token
list	=	[token]
list	=	[token]list
string	=	<chars>\|<empty>
token	=	string
token	=	string*token