# music-wallpaper

**Repository Path**: CrimsonHu/music-wallpaper

## Basic Information

- **Project Name**: music-wallpaper
- **Description**: 基于Electron开发的桌面插件，在壁纸层显示音频可视化效果
- **Primary Language**: TypeScript
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 10
- **Forks**: 4
- **Created**: 2023-02-13
- **Last Updated**: 2025-11-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 让你的桌面随着音乐动起来！

#### 介绍
基于Electron开发的桌面插件，将系统音频可视化显示在桌面壁纸上

![预览图](demo/view.gif)

#### 使用方法
1.  在Release发行版中提供Windows平台的可执行文件，下载后解压即，运行application.exe
2.  使用任意播放器播放音乐，或者任意视频播放，或者运行游戏等，会在桌面上看到系统音频的动态效果
3.  该程序运行后存在于托盘栏内，托盘栏图标提供菜单，可以显示/隐藏各个效果

![桌面效果图](demo/menu.png)

#### 实现过程
1.  通过Windows API实现将Electron界面嵌入到桌面图标层与壁纸层之间
2.  通过Electron提供的接口抓取系统音频，放入AudioContext中
3.  在Cnavas上显示音频可视化效果

#### 详细解析
[https://juejin.cn/post/7201363501569785915](https://juejin.cn/post/7201363501569785915)

#### 代码运行方法
1.  需要C++编译环境（建议安装Visual Studio）
2.  拉取代码，执行npm install
3.  执行npm run gyp-rebuild，编译native目录下的attach.cpp
4.  执行npm run start，即可运行代码

#### 打包方法
1.  npm run package-build:win

#### 图片展示
![桌面效果图](demo/1.png)
![桌面效果图](demo/2.png)