├── .github └── workflows │ └── docs.yml ├── .gitignore ├── .swiftpm └── xcode │ ├── package.xcworkspace │ └── contents.xcworkspacedata │ └── xcuserdata │ └── haren724.xcuserdatad │ └── xcschemes │ └── xcschememanagement.plist ├── Package.swift ├── README.md └── Sources ├── User_Documentation_en_US ├── Documentation.docc │ ├── Resources │ │ └── documentation-art │ │ │ └── WallpaperPlayer-icon@2x.png │ ├── articles │ │ ├── import-your-first-wallpaper.md │ │ └── supported-wallpaper-types.md │ └── homepage.md └── UserDocumentation.swift └── User_Documentation_zh_CN ├── Documentation.docc ├── Resources │ └── documentation-art │ │ └── WallpaperPlayer-icon@2x.png ├── articles │ ├── import-your-first-wallpaper.md │ └── supported-wallpaper-types.md └── homepage.md └── UserDocumentation.swift /.github/workflows/docs.yml: -------------------------------------------------------------------------------- 1 | name: Documentation 2 | 3 | on: 4 | push: 5 | branches: 6 | - main 7 | workflow_dispatch: 8 | 9 | # Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages 10 | permissions: 11 | contents: read 12 | pages: write 13 | id-token: write 14 | 15 | # Allow one concurrent deployment 16 | concurrency: 17 | group: "pages" 18 | cancel-in-progress: true 19 | 20 | jobs: 21 | docs: 22 | runs-on: ubuntu-22.04 23 | 24 | steps: 25 | - uses: actions/checkout@v4.2.2 26 | - name: Set up Pages 27 | uses: actions/configure-pages@v5.0.0 28 | - name: Set up Swift 29 | uses: swift-actions/setup-swift@v2.2.0 30 | with: 31 | swift-version: '6.0.0' 32 | - name: Generate Docs (en_US) 33 | run: | 34 | mkdir -p ./docs/en_us 35 | swift package --allow-writing-to-directory ./docs/en_us \ 36 | generate-documentation --target "User_Documentation_en_US" \ 37 | --disable-indexing \ 38 | --transform-for-static-hosting \ 39 | --hosting-base-path "wallpaper-player-mac/en_us" \ 40 | --output-path ./docs/en_us 41 | - name: Generate Docs (zh_CN) 42 | run: | 43 | mkdir -p ./docs/zh_cn 44 | swift package --allow-writing-to-directory ./docs/zh_cn \ 45 | generate-documentation --target "User_Documentation_zh_CN" \ 46 | --disable-indexing \ 47 | --transform-for-static-hosting \ 48 | --hosting-base-path "wallpaper-player-mac/zh_cn" \ 49 | --output-path ./docs/zh_cn 50 | - name: Upload artifact 51 | uses: actions/upload-pages-artifact@v3.0.1 52 | with: 53 | path: ./docs 54 | 55 | deploy: 56 | environment: 57 | name: github-pages 58 | url: ${{ steps.deployment.outputs.page_url }} 59 | runs-on: ubuntu-latest 60 | needs: docs 61 | 62 | steps: 63 | - name: Deploy Docs 64 | uses: actions/deploy-pages@v4.0.5 65 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | .build 2 | .index-build 3 | DerivedData 4 | /.previous-build 5 | xcuserdata 6 | .DS_Store 7 | *~ 8 | \#* 9 | .\#* 10 | .*.sw[nop] 11 | *.xcscmblueprint 12 | /default.profraw 13 | *.xcodeproj 14 | Utilities/Docker/*.tar.gz 15 | .swiftpm 16 | Package.resolved 17 | /build 18 | *.pyc 19 | .docc-build 20 | .vscode 21 | Utilities/InstalledSwiftPMConfiguration/config.json 22 | .devcontainer 23 | xcschememanagement.plist 24 | *.xcscheme 25 | -------------------------------------------------------------------------------- /.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata: -------------------------------------------------------------------------------- 1 | 2 | 4 | 6 | 7 | 8 | -------------------------------------------------------------------------------- /.swiftpm/xcode/xcuserdata/haren724.xcuserdatad/xcschemes/xcschememanagement.plist: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | SchemeUserState 6 | 7 | Wallpaper_Player_Documentation.xcscheme_^#shared#^_ 8 | 9 | orderHint 10 | 0 11 | 12 | Wallpaper_Player_User_Documentation.xcscheme_^#shared#^_ 13 | 14 | orderHint 15 | 1 16 | 17 | 18 | SuppressBuildableAutocreation 19 | 20 | UserDocumentation 21 | 22 | primary 23 | 24 | 25 | Wallpaper_Player_Documentation 26 | 27 | primary 28 | 29 | 30 | Wallpaper_Player_User_Documentation 31 | 32 | primary 33 | 34 | 35 | 36 | 37 | 38 | -------------------------------------------------------------------------------- /Package.swift: -------------------------------------------------------------------------------- 1 | // swift-tools-version: 6.0 2 | // The swift-tools-version declares the minimum version of Swift required to build this package. 3 | 4 | import PackageDescription 5 | 6 | let package = Package( 7 | name: "Wallpaper_Player_Documentation", 8 | products: [ 9 | .library( 10 | name: "Wallpaper_Player_Documentation", 11 | targets: ["User_Documentation_en_US", "User_Documentation_zh_CN"])], 12 | dependencies: [ 13 | .package(url: "https://github.com/apple/swift-docc-plugin", from: "1.0.0")], 14 | targets: [ 15 | .target(name: "User_Documentation_en_US"), 16 | .target(name: "User_Documentation_zh_CN")] 17 | ) 18 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Wallpaper Player 2 | 3 | An open source wallpaper engine for mac (which is not relative to the existing one on Steam) 4 | 5 |

6 | Testflight 7 |

8 | 9 | Hi there! 10 | I hosted a chat group on QQ: `228230228` 11 | Guys If you are interested in contributing to this project, please 12 | join this chat so that we could communicate much easier. 13 | 14 | 大家好呀！ 15 | 我在QQ上建了个群：`228230228` 16 | 如果您有兴趣为这个项目做出贡献，不介意的话加一下呗，以便我们可以更方便地沟通。 17 | -------------------------------------------------------------------------------- /Sources/User_Documentation_en_US/Documentation.docc/Resources/documentation-art/WallpaperPlayer-icon@2x.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/haren724/wallpaper-player-mac/889b9d6694264abb40e2905587cf3f9d42cb8fee/Sources/User_Documentation_en_US/Documentation.docc/Resources/documentation-art/WallpaperPlayer-icon@2x.png -------------------------------------------------------------------------------- /Sources/User_Documentation_en_US/Documentation.docc/articles/import-your-first-wallpaper.md: -------------------------------------------------------------------------------- 1 | # Import your first Wallpaper 2 | 3 | Teach you how to add and display your first wallpaper using this App 4 | 5 | ## Overview 6 | 7 | To learn more about wallpaper types, see 8 | 9 | ### Section header 10 | 11 | Text 12 | -------------------------------------------------------------------------------- /Sources/User_Documentation_en_US/Documentation.docc/articles/supported-wallpaper-types.md: -------------------------------------------------------------------------------- 1 | # Supported Wallpaper Types 2 | 3 | 4 | -------------------------------------------------------------------------------- /Sources/User_Documentation_en_US/Documentation.docc/homepage.md: -------------------------------------------------------------------------------- 1 | # ``User_Documentation_en_US`` 2 | 3 | @Metadata { 4 | @DisplayName("Wallpaper Player (English)") 5 | @DocumentationExtension(mergeBehavior: override) 6 | @PageImage( 7 | purpose: icon, 8 | source: "WallpaperPlayer-icon", 9 | alt: "A technology icon representing the Wallpaper_Player framework.") 10 | @PageColor(blue) 11 | } 12 | 13 | An open source wallpaper engine for Mac. 14 | 15 | ## Overview 16 | 17 | Wallpaper Player is your ideal, brilliant and dynamic desktop picture manager. 18 | It supports multiple media types to be added to your desktop. 19 | 20 | ## Topics 21 | 22 | ### Essentials 23 | 24 | - 25 | -------------------------------------------------------------------------------- /Sources/User_Documentation_en_US/UserDocumentation.swift: -------------------------------------------------------------------------------- 1 | // 2 | // File.swift 3 | // Wallpaper Player Documentation 4 | // 5 | // Created by Haren on 2025/1/16. 6 | // 7 | 8 | import Foundation 9 | 10 | class User_Documentation { 11 | 12 | } 13 | -------------------------------------------------------------------------------- /Sources/User_Documentation_zh_CN/Documentation.docc/Resources/documentation-art/WallpaperPlayer-icon@2x.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/haren724/wallpaper-player-mac/889b9d6694264abb40e2905587cf3f9d42cb8fee/Sources/User_Documentation_zh_CN/Documentation.docc/Resources/documentation-art/WallpaperPlayer-icon@2x.png -------------------------------------------------------------------------------- /Sources/User_Documentation_zh_CN/Documentation.docc/articles/import-your-first-wallpaper.md: -------------------------------------------------------------------------------- 1 | # 导入你的第一张壁纸 2 | 3 | 引导你使用本app导入并使用你的第一张壁纸 4 | 5 | ## 总览 6 | 7 | 如果想了解软件支持的所有壁纸类型，请查阅 8 | 9 | ### 子标题 10 | -------------------------------------------------------------------------------- /Sources/User_Documentation_zh_CN/Documentation.docc/articles/supported-wallpaper-types.md: -------------------------------------------------------------------------------- 1 | # 支持的壁纸类型 2 | 3 | 4 | -------------------------------------------------------------------------------- /Sources/User_Documentation_zh_CN/Documentation.docc/homepage.md: -------------------------------------------------------------------------------- 1 | # ``User_Documentation_zh_CN`` 2 | 3 | @Metadata { 4 | @DisplayName("Wallpaper Player (Chinese Simplified)") 5 | @DocumentationExtension(mergeBehavior: override) 6 | @PageImage( 7 | purpose: icon, 8 | source: "WallpaperPlayer-icon", 9 | alt: "A technology icon representing the Wallpaper_Player framework.") 10 | @PageColor(blue) 11 | } 12 | 13 | Mac平台的开源壁纸引擎 14 | 15 | ## 总览 16 | 17 | Wallpaper Player是macOS下完成度最高的壁纸软件之一，并支持多种媒体格式。 18 | 19 | ## 话题 20 | 21 | ### 基础 22 | 23 | - 24 | -------------------------------------------------------------------------------- /Sources/User_Documentation_zh_CN/UserDocumentation.swift: -------------------------------------------------------------------------------- 1 | // 2 | // File.swift 3 | // Wallpaper Player Documentation 4 | // 5 | // Created by Haren on 2025/1/16. 6 | // 7 | 8 | import Foundation 9 | 10 | class User_Documentation { 11 | 12 | } 13 | --------------------------------------------------------------------------------