{"id":29906770,"url":"https://github.com/svdotsenko/cleaner","last_synced_at":"2025-08-01T21:13:02.153Z","repository":{"id":306627413,"uuid":"1023435359","full_name":"SVDotsenko/cleaner","owner":"SVDotsenko","description":"Simple file manager written in PowerShell for Windows. Manage audio files with smart sorting and bulk operations","archived":false,"fork":false,"pushed_at":"2025-07-26T16:25:54.000Z","size":38,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-26T21:26:17.062Z","etag":null,"topics":["cursor-ai"],"latest_commit_sha":null,"homepage":"","language":"PowerShell","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SVDotsenko.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-21T06:55:18.000Z","updated_at":"2025-07-26T18:59:14.000Z","dependencies_parsed_at":"2025-07-26T21:37:47.694Z","dependency_job_id":null,"html_url":"https://github.com/SVDotsenko/cleaner","commit_stats":null,"previous_names":["svdotsenko/cleaner"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/SVDotsenko/cleaner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SVDotsenko%2Fcleaner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SVDotsenko%2Fcleaner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SVDotsenko%2Fcleaner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SVDotsenko%2Fcleaner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SVDotsenko","download_url":"https://codeload.github.com/SVDotsenko/cleaner/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SVDotsenko%2Fcleaner/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268297590,"owners_count":24228126,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-01T02:00:08.611Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cursor-ai"],"created_at":"2025-08-01T21:12:59.587Z","updated_at":"2025-08-01T21:13:02.143Z","avatar_url":"https://github.com/SVDotsenko.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# File Manager in PowerShell\n\n## Description\n\nA graphical application for Windows written in PowerShell, designed for convenient viewing, sorting, and deleting files in a selected folder. Allows you to quickly work with large lists of files, supports deletion to Recycle Bin, opening files with a double-click, sorting by name, size, and date, as well as displaying statistics on the number and size of files.\n\n**New Feature**: Comments functionality allows you to read and edit comments/metadata in audio files (MP3, M4A, OGG).\n\n---\n\n## Installation\n\n1. Download the `FileManager.ps1` file to any convenient folder.\n2. Make sure you have PowerShell 5.1 (or newer) installed on your computer.\n3. (Recommended) To run without a console window, create a shortcut with the `-WindowStyle Hidden` parameter or use a .vbs wrapper.\n\n### Additional Requirements for Comments Functionality\n\nTo use the comments feature (reading and editing file comments), you need to install additional components:\n\n#### 1. PowerShell 7+ (Required)\nThe comments functionality requires PowerShell 7 or newer. To install:\n\n**Option A - Using winget (recommended):**\n```\nwinget install Microsoft.PowerShell\n```\n\n**Option B - Manual download:**\n- Go to https://github.com/PowerShell/PowerShell/releases\n- Download the latest version for Windows\n- Install and restart your computer\n\n#### 2. TagLibCli Module (Required)\nInstall the TagLibCli PowerShell module:\n\n```powershell\nInstall-Module -Name TagLibCli -Force\n```\n\n**Note**: This module includes the necessary TagLibSharp.dll file for reading/writing audio file metadata.\n\n#### 3. Verification\nAfter installation, you can verify everything is working by running:\n```powershell\n$PSVersionTable.PSVersion  # Should show 7.x.x\nGet-Module -Name TagLibCli -ListAvailable  # Should show the module\n```\n\n---\n\n## Launch\n\n- Double-click the `FileManager.ps1` file (if .ps1 files are associated with PowerShell).\n- Or run via PowerShell with the command:\n  ```\n  powershell.exe -ExecutionPolicy Bypass -File \"C:\\path\\to\\FileManager.ps1\"\n  ```\n- To run without a console window, use a shortcut:\n  ```\n  powershell.exe -WindowStyle Hidden -ExecutionPolicy Bypass -File \"C:\\path\\to\\FileManager.ps1\"\n  ```\n\n**Important**: For comments functionality, make sure you're running with PowerShell 7+.\n\n---\n\n## Usage\n\n- By default, the folder `G:\\My Drive\\recordings` is opened (if it exists).\n- You can select another folder using the \"Folder\" button.\n- The table displays files with extensions `.m4a`, `.mp3`, `.ogg`.\n- Sorting by name, size, and date is available (buttons at the top of the window).\n- To delete, select files and click \"Delete\" (you can choose to delete to Recycle Bin or permanently).\n- Double-clicking a file opens it in the default application.\n- At the bottom, statistics on the number and size of files are displayed.\n\n### Comments Feature\n- Select a single audio file to view its comments in the text box below the \"Folder\" button.\n- Edit the comments and click \"Update\" to save changes.\n- The feature only works with audio files (MP3, M4A, OGG).\n- If requirements are not met, you'll see notification messages and the comments interface will be hidden.\n\n---\n\n## Configuration\n\n- The default folder path can be changed in the `$global:folderPath` variable at the beginning of the script.\n- Font size and family are set by the `$global:fontSize` and `$global:fontFamily` variables.\n- To run without a console window, use a shortcut with the `-WindowStyle Hidden` parameter or a .vbs wrapper.\n\n---\n\n## Requirements\n\n- Windows with PowerShell 5.1 or newer installed.\n- Does not require third-party libraries for basic functionality.\n- Does not make changes to the system.\n- To run without a console window, it is recommended to use a shortcut or a .vbs wrapper.\n\n### For Comments Functionality:\n- **PowerShell 7+** (required)\n- **TagLibCli module** (required)\n- Audio files with supported formats (MP3, M4A, OGG)\n\nIf requirements are not met, the application will show notification messages and disable the comments interface.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsvdotsenko%2Fcleaner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsvdotsenko%2Fcleaner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsvdotsenko%2Fcleaner/lists"}