{"id":27796516,"url":"https://github.com/lhx077/fsbprocessor","last_synced_at":"2025-08-11T07:04:48.398Z","repository":{"id":290214679,"uuid":"973651816","full_name":"lhx077/FSBProcessor","owner":"lhx077","description":"A Tool Can Process FSB Files(FSBank/FMOD sound banks) EASILY","archived":false,"fork":false,"pushed_at":"2025-05-08T18:13:45.000Z","size":56,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-13T00:17:24.636Z","etag":null,"topics":["audio","audio-processing","audio-processor","fmod","fsb","fsb5","mod","unity"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lhx077.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-04-27T13:01:13.000Z","updated_at":"2025-07-12T15:02:33.000Z","dependencies_parsed_at":"2025-04-27T16:41:10.508Z","dependency_job_id":null,"html_url":"https://github.com/lhx077/FSBProcessor","commit_stats":null,"previous_names":["lhx077/fsbprocessor"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/lhx077/FSBProcessor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lhx077%2FFSBProcessor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lhx077%2FFSBProcessor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lhx077%2FFSBProcessor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lhx077%2FFSBProcessor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lhx077","download_url":"https://codeload.github.com/lhx077/FSBProcessor/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lhx077%2FFSBProcessor/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269844098,"owners_count":24484132,"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-11T02:00:10.019Z","response_time":75,"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":["audio","audio-processing","audio-processor","fmod","fsb","fsb5","mod","unity"],"created_at":"2025-04-30T20:59:06.932Z","updated_at":"2025-08-11T07:04:48.386Z","avatar_url":"https://github.com/lhx077.png","language":"C#","readme":"\u003e **⚠️ 警告：** 本项目目前处于Alpha阶段，可能出现不可用情况。请谨慎使用于生产环境！\n\n[English Version](https://github.com/lhx077/FSBProcessor/blob/main/README_EN.md)\n\n# FSBProcessor 库 （FSBLib）\n\n## 简介\n\nFSBProcessor（FSBLib） 是一个用于处理 FMOD 的 FSB (FSBank) 格式音频文件的 C# 库。该库提供了将 FSB 文件解码为普通音频格式（如 WAV）以及将普通音频打包为 FSB 格式的功能，方便 Unity/UE 游戏制作 mod 使用。\n\n## 功能特点\n\n- 解析 FSB 文件结构，提取音频信息\n- 将 FSB 文件解码为 WAV 格式\n- 将普通音频文件（如 WAV、MP3 等）打包为 FSB 格式\n- 支持 WAV 文件直接打包为 FSB 格式\n- 支持多种 FSB 版本（FSB1-FSB5）的完整解析\n- 支持多种音频格式（PCM、MP3、Vorbis 等）\n- 精确提取元数据中的采样率信息\n\n## 系统要求\n\n- .NET Standard 2.0 或更高版本\n- 依赖 NAudio 库进行音频处理\n\n## 安装方法\n\n1. 克隆或下载本仓库\n2. 使用 Visual Studio 打开 FSBProcessor.sln 解决方案文件\n3. 编译项目生成 FSBLib.dll\n4. 在您的项目中引用生成的 DLL 文件\n\n## 使用示例\n\n### 解析 FSB 文件\n\n```csharp\nusing FSBLib;\n\n// 创建 FSBProcessor 实例\nvar processor = new FSBProcessor();\n\n// 解析 FSB 文件，获取音频信息\nvar samples = processor.ParseFSB(\"path/to/your/file.fsb\");\n\n// 显示音频信息\nforeach (var sample in samples)\n{\n    Console.WriteLine($\"名称: {sample.Name}\");\n    Console.WriteLine($\"格式: {sample.Format}\");\n    Console.WriteLine($\"通道数: {sample.Channels}\");\n    Console.WriteLine($\"采样率: {sample.SampleRate} Hz\");\n    Console.WriteLine($\"长度: {sample.Length} 字节\");\n    Console.WriteLine();\n}\n```\n\n### 将 FSB 文件解码为 WAV 格式\n\n```csharp\nusing FSBLib;\n\n// 创建 FSBProcessor 实例\nvar processor = new FSBProcessor();\n\n// 将 FSB 文件解码为 WAV 文件\nvar outputFiles = processor.ExtractToWav(\"path/to/your/file.fsb\", \"output/directory\");\n\n// 显示输出文件路径\nConsole.WriteLine(\"已解码的文件:\");\nforeach (var file in outputFiles)\n{\n    Console.WriteLine(file);\n}\n```\n\n### 将普通音频文件打包为 FSB 格式\n\n```csharp\nusing FSBLib;\nusing System.Collections.Generic;\n\n// 创建 FSBProcessor 实例\nvar processor = new FSBProcessor();\n\n// 准备要打包的音频文件列表\nvar audioFiles = new List\u003cstring\u003e\n{\n    \"path/to/audio1.wav\",\n    \"path/to/audio2.mp3\",\n    \"path/to/audio3.wav\"\n};\n\n// 将音频文件打包为 FSB 文件\nprocessor.PackToFSB(audioFiles, \"output.fsb\", FSBProcessor.FSBVersion.FSB5);\n\nConsole.WriteLine(\"打包完成: output.fsb\");\n```\n\n### 将 WAV 文件打包为 FSB 格式\n\n```csharp\nusing FSBLib;\nusing System.Collections.Generic;\n\n// 创建 FSBProcessor 实例\nvar processor = new FSBProcessor();\n\n// 准备要打包的WAV文件列表\nvar wavFiles = new List\u003cstring\u003e\n{\n    \"path/to/audio1.wav\",\n    \"path/to/audio2.wav\"\n};\n\n// 将WAV文件打包为FSB文件（保留原始格式）\nprocessor.PackWavToFSB(wavFiles, \"output.fsb\", FSBProcessor.FSBVersion.FSB5);\n\nConsole.WriteLine(\"打包完成: output.fsb\");\n```\n\n## 注意事项\n\n- 库现已支持多种音频格式，包括 PCM、MP3 和 Vorbis 格式\n- 新增对 WAV 文件的直接打包支持，保留原始音频格式和质量\n- FSB5 格式现已得到完整支持，包括元数据采样率的精确提取\n- 对于某些特殊的 FSB 文件，可能需要进一步的格式适配\n- 使用 PackWavToFSB 方法可以获得更好的音频质量和更精确的格式控制\n\n## 许可证\n\n本项目采用 Apache License 2.0\n\n## 贡献\n\n欢迎提交问题报告和改进建议！\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flhx077%2Ffsbprocessor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flhx077%2Ffsbprocessor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flhx077%2Ffsbprocessor/lists"}