Blue Iris Clips and Files - Disk Usage Utility

M Hotchin said:

Changing two lines as follows:
913 - :
if ($cur_ary_cnt -gt 0 -and $Days -ne 0) {

2722:
if ($timestamp_output_csv_files_flg -and $archive_lifetime_days -ne 0) {

allows the option $archive_lifetime_days to be set to negative numbers. ANY negative number will prune ALL the CSV files. Other values behave the same as before.

I don't need history of usage, this cleans up the CSV files created for the report.

Click to expand...

1. BREAKING CHANGE: additional user-setting; change to a user setting
2. NEW: added user setting $experienced_user_flg to hide output intended for first-time users
3. CHANGE: user setting $archive_lifetime_days now supports negative integer (prunes all archive files)

• Monitoring the file count in each Blue Iris storage folder may help to avoid sluggish file management (possibly starting at ~10,000 files; see this ChatGPT query). This includes impacting the performance of this Powershell script!
• If you routinely protect clips/alerts, then you should pay attention to the ratio of READ-ONLY files and increase the folder storage allocation accordingly
• Windows File Explorer displays file timestamps in the CURRENT local timezone; therefore the time shown for old files may be off by an hour from their actual created time. V8 shows the file's actual creation timezone of in the Oldest column (e.g., PST/PDT)
• New arguments that enable the on-demand overriding of default user-settings (-NoTimestamp and -NoPruning). I use the -NoTimestamp argument when executing the script the console, and use timestamping only when running the script from Task Scheduler.
• A new argument that enables the easy purging of all archived output tables (-ClearArchive)

1. NEW: added stats for the quantity of READ-ONLY (protected) files in each folder
2. NEW: added timezone designator to the oldest and newest date columns
3. NEW: added argument -NoTimestamp to override the time stamping of the output CSV files
4. NEW: added argument -NoPruning to disable the pruning of old CSV files
5. NEW: added argument -ClearArchive to delete archived (old) CSV files on demand
6. NEW: script now checks if the commandline contains unsupported argument(s)
7. CHANGED: now showing file CreationTime (previously LastWriteTime) in output table's 'Oldest' & 'Newest' date columns
8. CHANGED: now showing time as HH:MM instead of HH:MM:SS in output table's 'Oldest' & 'Newest' date columns
9. CHANGED: eliminated redundant TOTAL row from output tables if the folder contains only one item
10. CHANGED: eliminated 'Oldest' & 'Newest' entries from the output table's TOTAL row
11. CHANGED: function PurgeOldFiles() now gets existing files ordered oldest to newest

• Monitoring the file count in each Blue Iris storage folder may help to avoid sluggish file management (possibly starting at ~10,000 files; see this ChatGPT query).

scoob8000 said:

I was playing with some camera bitrate settings and just thought of a feature request. How hard would it be to add a column to the BVR section of average GB per day?

Click to expand...

scoob8000 said:

I was thinking more basic math, but to be fair I don't really know how accurate it would be.

We already know the number of days for each cam, and total size per cam. Would dividing size by days get us pretty close?

Click to expand...

1. BREAKING CHANGE: added new user-settings; must update user-settings file before using this script
2. FIXED: eliminated error when camera does not have a 'continuous' reg key in reg path HKLM\SOFTWARE\Perspective Software\Blue Iris\Cameras\{camname}\Clips\{profile#}
3. ADDED: MIT license notification
4. ADDED: argument -Daily to insert a daily usage column like 'DailyGB' (thanks @scoob8000)
5. ADDED: user-setting $show_daily_usage_flg to make -Daily the default action
6. ADDED: arguments -FilterHours & -FilterStartDate & -Force to filter a time "window"
7. ADDED: argument -WholeDaysOnly to exclude the current partial day
8. ADDED: user-setting $whole_days_only_flg to make -WholeDaysOnly the default action
9. ADDED: argument -Folders to limit output to specified folders, like -Folders 'new','alerts'
10. ADDED: argument -NoCsv to limit output to console only
11. ADDED: argument -SaveTranscript to enable transcribing of script (useful for debugging)
12. ADDED: argument -ResetJsonId (useful for when script stops working as expected)
13. ADDED: support for global kill switch (file C:\BlueIris\www\PS_KILL_SWITCH.txt exist); see companion scripts 'ps_kill_scripts_on.ps1|cmd' and 'ps_kill_scripts_off.ps1|cmd'
14. IMPROVED: the grouped by file extension tables for each folder are now dynamically determined (no longer hard-coded); this avoids situations like in v5.9.9.44 where Blue Iris, for the first time, added *.dat files to the New folder
15. IMPROVED: script now tests for unexpected files in all Blue Iris storage folders (other than: *.bvr, *.dat, *.jpg, or *.mp4)
16. IMPROVED: script now executes 2x faster (code refactored and uses a unified per-file object model and pre-grouped files by extension once per folder)
17. IMPROVED: script now displays progress bars when parsing the largest folders (5000 or more files)
18. IMPROVED: script now detects and warns if using unsupported arguments
19. IMPROVED: user passwords are no longer required in the user-settings-file (unless using the encryption option)