{"id":15107948,"url":"https://github.com/vodka2/vk-music-fs","last_synced_at":"2025-09-13T14:35:44.622Z","repository":{"id":119605676,"uuid":"148884103","full_name":"vodka2/vk-music-fs","owner":"vodka2","description":"FUSE file system for VK audios","archived":false,"fork":false,"pushed_at":"2022-02-05T02:30:39.000Z","size":757,"stargazers_count":38,"open_issues_count":2,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-06T15:40:12.465Z","etag":null,"topics":["audio","filesystem","fuse","vk","vkontakte"],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"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/vodka2.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.ru.md","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}},"created_at":"2018-09-15T08:29:59.000Z","updated_at":"2024-12-11T22:04:40.000Z","dependencies_parsed_at":"2023-04-05T14:48:07.108Z","dependency_job_id":null,"html_url":"https://github.com/vodka2/vk-music-fs","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/vodka2/vk-music-fs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vodka2%2Fvk-music-fs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vodka2%2Fvk-music-fs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vodka2%2Fvk-music-fs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vodka2%2Fvk-music-fs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vodka2","download_url":"https://codeload.github.com/vodka2/vk-music-fs/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vodka2%2Fvk-music-fs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274976892,"owners_count":25384285,"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-09-13T02:00:10.085Z","response_time":70,"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","filesystem","fuse","vk","vkontakte"],"created_at":"2024-09-25T21:43:24.871Z","updated_at":"2025-09-13T14:35:44.610Z","avatar_url":"https://github.com/vodka2.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VK Music FS\n\n[![Build Status](https://travis-ci.com/vodka2/vk-music-fs.svg?branch=master)](https://travis-ci.com/vodka2/vk-music-fs)\n\nRead this in [russian](README.ru.md). Also more up to date.\n\n![VK Music FS screenshot](https://i.imgur.com/OoiJfaW.gif)\n\nFUSE virtual system for VK (Vkontakte) audios. VK account is required.\n\n## Description\n\nThe program makes it possible to listen to the music from VK using your favorite player and copy songs to your PC. Searching and obtaining Mp3 files from \"My audios\" is supported. Missing ID3v2 tags are automatically added.\n\n## Installation\n\n### Windows\n\nWindows 7 or later is supported.\n\n1. Download and install [WinFsp driver](https://github.com/billziss-gh/winfsp/releases).\n2. Download `vk_music_fs.exe` from releases\n3. Copy WinFsp DLL from `C:\\Program Files\\WinFsp\\bin` to the `vk_music_fs.exe` directory\n\n### Linux\n\nDownload appimage from releases: `vk_music_fs-i386.AppImage` or `vk_music_fs-x86_64.AppImage`. Appimages are executable files with bundled dependencies.\n\nInstallation from source:\n\n1. Install the following packages: `cmake g++ libssl-dev libfuse-dev libboost-system1.67-dev libboost-thread1.67-dev libboost-filesystem1.67-dev libboost-program-options1.67-dev zlib1g-dev` GCC compiler must support C++17\n2. Execute in the sources directory: `mkdir build \u0026\u0026 cd build \u0026\u0026 cmake .. -DCMAKE_BUILD_TYPE=Release \u0026\u0026 cmake --build . --target vk_music_fs`\n3. Copy `vk_music_fs` to the preferred location\n\n### OS X\n\nInstallation from source:\n\n1. Install the following packages `cmake gcc openssl osxfuse boost`\n2. Execute in the sources directory:\n```\nmkdir build \u0026\u0026 cd build \u0026\u0026 cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_COMPILER=/usr/local/bin/g++-8 -DCMAKE_C_COMPILER=/usr/local/bin/gcc-8 \u0026\u0026 cmake --build . --target vk_music_fs\n```\n\n## Usage\n\n### General\n\n#### Linux\n\nRun `vk_music_fs --get_token vk_login vk_password`. The program will print the token and the user agent, copy these two lines to the `VkMusicFs.ini` file either in the same directory or in the configuration folder `~/.config/VkMusicFs/VkMusicFs.ini`. Create a mount point: `mkdir ~/VkMusicFs`. Then launch the program again: `vk_music_fs ~/VkMusicFs` and the file system will be mounted.\n\nPlease disable thumbnails for Mp3 files in the file system directory.\n\n#### Windows\n\nRun `vk_music_fs --get_token vk_login vk_password`. The program will print the token and the user agent, copy these two lines to the `VkMusicFs.ini` file either in the same directory or in the configuration folder `C:\\Users\\\u003cUsername\u003e\\AppData\\Roaming\\VkMusicFs\\VkMusicFs.ini`. Then launch the program again: `vk_music_fs` and the file system will be mounted. The default mount point is `Z:`.\n\n**Please select \"Optimize this folder for: Documents\" in folder properties, or it may be very slow.**\n\nOnly mounting as a disk is supported. It may be necessary to add `-o uid=-1,gid=-1` option when mounting fails.\n\n#### OS X\n\nRun `vk_music_fs --get_token vk_login vk_password`. The program will print the token and the user agent, copy these two lines to the `VkMusicFs.ini` file either in the same directory or in the configuration folder `~/Library/Application Support/VkMusicFs/VkMusicFs.ini`. Create a mount point: `mkdir ~/VkMusicFs`. Then launch the program again: `vk_music_fs -o modules=iconv,from_code=UTF-8,to_code=UTF-8-MAC ~/VkMusicFs` and the file system will be mounted.\n\nPlease disable thumbnails for the file system directory: in Finder press Command+J, then uncheck \"Show icon preview\" and click on \"Use as defaults\".\n\n\n### Commands\n\nIn `My audios` and `Search` directories:\n\n1. Create a directory with numeric name, and the parent directory will contain the specified number of Mp3 files\n2. Create a directory with name like `10-30` to load 30 files starting from offset 10\n\nIn `Search` directory:\n\n1. Create a directory with name, say, `Justin Bieber` to search for the songs by this artist\n2. Create a directory with name `Baby` inside the `Justin Bieber` directory and the search query will be `Justin Bieber Baby`.\n\nIt is possible to delete directories and files.\n\n### Command-line options\n\nDefault values may differ for your OS and extra FUSE options are not shown.\n\n```\nUsage ./vk_music_fs mountpoint [options]\n\nGeneral options:\n  --token arg                           set token\n  --user_agent arg                      set user agent\n  --sizes_cache_size arg (=10000)       set max number of remote file sizes in\n                                        cache\n  --files_cache_size arg (=300)         set max number of remote files in cache\n  --mp3_ext arg (=.mp3)                 set mp3 files extension\n  --num_search_files arg (=10)          set initial number of files in the\n                                        search directory\n  --cache_dir arg (=/home/vodka2/.cache/VkMusicFs/)\n                                        set cache dir\n  --create_dummy_dirs arg (=0)          create dummy dirs\n  --num_size_retries arg (=3)           set max number of HEAD requests when\n                                        retrieving size\n  --err_log arg (=/home/vodka2/.config/VkMusicFs/ErrorLog.txt)\n                                        set error log file name\n  --log_err_to_file arg (=0)            log errors to file\n  --http_timeout arg (=12000)           set HTTP requests timeout in\n                                        milliseconds\n  --help                                produce help message\n  --clear_cache                         clear remote files and remote file\n                                        sizes cache\nToken options:\n  --get_token arg       Obtain token by login and password\n\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvodka2%2Fvk-music-fs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvodka2%2Fvk-music-fs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvodka2%2Fvk-music-fs/lists"}