diff --git a/.github/workflows/Dynamic-Readme.yml b/.github/workflows/Dynamic-Readme.yml new file mode 100644 index 0000000..df58ce7 --- /dev/null +++ b/.github/workflows/Dynamic-Readme.yml @@ -0,0 +1,35 @@ +name: "๐Ÿ“„ Dynamic ReadME" + +env: + VS_WORKFLOW_TYPE: "dynamic-readme" + +on: + workflow_dispatch: + push: + branches: + - main + paths: + - README.md + +jobs: + update_readme: + name: "Render & Update ReadME" + runs-on: ubuntu-latest + steps: + - name: "๐Ÿ“ฅ Fetching Repository Contents" + uses: actions/checkout@main + + - name: "๐Ÿ’พ Github Repository Metadata" + uses: varunsridharan/action-repository-meta@main + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + + - name: "๐Ÿ’ซ Update README.md" + uses: "varunsridharan/action-dynamic-readme@main" + with: + GLOBAL_TEMPLATE_REPOSITORY: Jax-Core/ReadME-Template/Templates + commit_message: โฉ File Rebuilt by Github Actions - Dynamic ReadME + files: | + README.md + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..12d1c9e --- /dev/null +++ b/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2022 JaxCore + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/README.md b/README.md index f0dd709..a9a3293 100644 --- a/README.md +++ b/README.md @@ -1,139 +1,86 @@ - +
- Logo + Logo

ModularPlayers

-

- Media Controls with gesture control and a multitude of features. -
- More Info ยป -
+ Gallery of desktop media widget which supports most media players
- Report Bugs & Request Features + Help, Report Bugs & Request Features ยป

+ + +

+ Latest by date + Discord + Github +

- - -
- Table of Contents -
    -
  1. - About -
  2. -
  3. - Features -
  4. -
  5. - Getting Started - -
  6. -
  7. Help & Credits
  8. - -
-
- + ## About -![ModularPlayers](https://images-wixmp-ed30a86b8c4ca887773594c2.wixmp.com/i/97bfd084-7ef0-496f-a835-3c41f482d38c/denufe0-a4a5dad3-3428-44da-a4e9-2acfc51592a7.png/v1/fill/w_1192,h_670,q_70,strp/modularplayers___adaptive_music_widget_by_jaxoriginals_denufe0-pre.jpg) - -ModularPlayers is a Rainmeter skin that includes a gallery of hand-crafted media controllers, a preview option, and an efficient settings menu. +![ModularPlayers](https://raw.githubusercontent.com/Jax-Core/ReadME-Template/main/Resources/Splash/ModularPlayers.png) + +**ModularPlayers** is a gallery of hand-crafted nowplaying metadata widgets. -## Features + +## Features * 10 Player Presets * Animated Styles -* Gesture Driven Media Controls +* Media controls +* Fully scalable + + ## Getting Started ### Prerequisites +- **Windows 10** or above +> For older systems, **Powershell v5.1 or newer** is required. Upgrade powershell **[here](https://docs.microsoft.com/en-us/powershell/scripting/windows-powershell/install/installing-windows-powershell?view=powershell-7.2#upgrading-existing-windows-powershell)**! -- **Rainmeter v4.5 or newer.** Rainmeter can be installed by downloading the `.exe` file [from Rainmeter's official website.](https://www.rainmeter.net/) -- **JaxCore v40005 or newer.** JaxCore can be installed by downloading the `.rmskin` file from [JaxCore's official website.](https://jax-core.github.io/) - -### Installation - -Assuming you successfully downloaded and installed Rainmeter as well as JaxCore, you can now proceed to install ModularPlayers by following the steps below. - -1. Download and run the `.rmskin` file for **ModularPlayers** from the official [JaxCore site](https://jax-core.github.io/) to install **ModularPlayers**. -2. Leave the installation settings at their defaults and click Install. -3. When the installation is finished, a startup pop-up should appear. Follow through the pop-up to finish installing **ModularPlayers**. - -* Note: If you find that the JaxCore option is red on the startup pop-up, please press the red button and Core will be installed automatically. Perchance this fails, you can manually install Core by downloading the `.rmskin` file from [JaxCore's official website.](https://jax-core.github.io/) - -### Setting Up +### Installation +Run the following command in Powershell to download the latest version of JaxCore. -To use the custom player styles, you must first install and configure **[ImageMagick](https://github.com/khanhas/MagickMeter) as well as [Spicetify](https://spicetify.app/).** If you already have **ImageMagick** and **Spicetify** setup, you can skip to choosing the presets; if not, follow the instructions below to setup **ImageMagick** and **Spicetify**. +(To launch Powershell as an Admin: `Win + R` -> `powershell` -> Press `CTRL + SHIFT + ENTER` on your keyboard. Powershell can also be launched via Windows Search.) +``` +Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/Jax-Core/JaxCore/master/CoreInstaller.ps1" | Invoke-Expression +``` -#### Installing ImageMagick: +> Alternatively you can download it from the [website](https://jax-core.github.io/) -1. Open **[this link](https://www.imagemagick.org/script/download.php#windows)**. This link will take you to another site where you must locate and download the appropriate installer. -2. Find a suitable release under **Windows Binary Release** that corresponds to your requirements and download it. The `ImageMagick-7.1.0-19-Q16-HDRI-x64-dll.exe` executable will be used to install for this guide. -3. After the download is complete, run the installer, which in this case is `ImageMagick-7.1.0-19-Q16-HDRI-x64-dll.exe`. -4. Leave the installation settings at their defaults and follow through the installation. You can tinker around with the settings **ONLY** if you know what they do. -5. Open **[this link](https://github.com/khanhas/MagickMeter/releases)** and dowload the latest release of the **MagickMeter** skin. The `magickmeter_0.7.3.rmskin` Rainmeter skin file will be used to install for this guide. -6. Leave the installation settings at their defaults and click Install. -7. Restart Rainmeter and your plugin will be activated. - -And that is how you setup **ImageMagick**. You can now proceed to configure the player Presets. - -* **Note:** An alternate approach for **Step 5** and **Step 6** is: - - Download the [plugin DLLs](https://github.com/khanhas/MagickMeter/releases) - - Copy the version that corresponds to your system from the zip file (x86 or x64) - - Open Run(`Win + R`), type `%appdata%\Rainmeter\Plugins\` and press **OK**. - - Manually paste DLL you copied in the second step. - - Finally, restart Rainmeter and your plugin will be activated. - -#### Installing Spicetify: - -1. Open Powershell (Windows 10) or Windows Terminal (Windows 11) and run the commands that follow: - ``` - Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/khanhas/spicetify-cli/master/install.ps1" | Invoke-Expression - - spicetify - - spicetify config extensions webnowplaying.js - ``` - **If you only want to install `webnowplaying.js` without the custom themes, use the following command:** - ``` - spicetify config inject_css 0 replace_colors 0 - ``` -2. And finally, run the following command to save and apply all your changes: - ``` - spicetify backup apply - ``` - -You can now proceed to choosing the presets. - -#### Choosing Presets: -Follow the steps outlined below to setup custom player presets: - -1. Open Core and head over to the **Desktop** section. -2. Select **ModularPlayers** from the list and proceed to the **Appearance** tab. -3. Under **Player Style** choose a preset that you like. -4. The player style will be changed if you refresh **ModularPlayers** by deactivating and activating the toggle on the bottom left. - -* **Note:** The **General** and **Appearance** tabs allow you to further customize each preset as required. - -## Help and Credits -- MediaPlayer plugin by [i2002](https://github.com/i2002) -- MagickMeter and ImageMagick plugins along with Spicetify by [khanhas](https://github.com/khanhas) -- Join the [Core Community Discord Server](https://discord.gg/JmgehPSDD6) for more help. +After you've proceeded through the welcome screen, select `ModularPlayers` (might have to scroll down) and click `Install`. It will appear in the library page after that. +
+
+ + +### Configuration +Use the JaxCore menu to configure ModularPlayers. +For more information, visit [JaxCore's documentation](https://jaxcore.gitbook.io/core/) +
+
+ + +## Need assistance? +* Join the [CoreCommunity Discord Server](https://discord.gg/JmgehPSDD6) for help +* or [Create an issue](https://github.com/Jax-Core/ModularPlayers) + +## Say Hi! +* Follow me on ๐Ÿ‘จโ€๐Ÿ’ป [Github](https://github.com/EnhancedJax) and stay updated on new things that I make +* You can also watch me on ๐Ÿฆ [DeviantArt](https://www.deviantart.com/jaxoriginals) instead +* Message me on ๐Ÿ—จ๏ธ [Discord](https://discord.gg/JmgehPSDD6) + +--- + +

+Made with โค๏ธ by Jax +

+ +