From 9e81d369c7b6ff2253ca2d7e4c43b2a5d0ded6b7 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:18 +1200 Subject: [PATCH 01/84] New translations build-instructions.md (English, United Kingdom) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/en-GB/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/en-GB/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/en-GB/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/en-GB/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From 9f29157dc5f675be0965e8671f4ff2b5adc186a2 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:20 +1200 Subject: [PATCH 02/84] New translations build-instructions.md (Romanian) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/ro-RO/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/ro-RO/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/ro-RO/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/ro-RO/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From 2e8a4fefe3c2959f4a0bb9518343e5d3e196a41b Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:21 +1200 Subject: [PATCH 03/84] New translations development.md (Romanian) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/ro-RO/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/ro-RO/docusaurus-plugin-content-docs/current/development/development.md b/i18n/ro-RO/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/ro-RO/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 886c3b55d1d5776599965c7b2eeee214d7f84244 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:23 +1200 Subject: [PATCH 04/84] New translations build-instructions.md (French) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/fr-FR/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/fr-FR/docusaurus-plugin-content-docs/current/development/build-instructions.md index a7b9bca9e..94f4bdb06 100644 --- a/i18n/fr-FR/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/fr-FR/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ Les progiciels suivants sont requis : - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Lisez la section [Instructions complètes] (#full-instructions) pour une explication complète de la façon dont -installer tous les logiciels nécessaires et comment construire UMS pour chaque système d'exploitation. - # Instructions de construction Si tous les paquets logiciels nécessaires sont installés, les commandes suivantes From 119c59ea0b9f3763b52686b71fd578ea1960bea9 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:24 +1200 Subject: [PATCH 05/84] New translations development.md (French) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/fr-FR/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/fr-FR/docusaurus-plugin-content-docs/current/development/development.md b/i18n/fr-FR/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/fr-FR/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From c8d3726cf181264d05baf10ea53d166dcf2807ac Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:26 +1200 Subject: [PATCH 06/84] New translations build-instructions.md (Spanish) [ci skip] --- .../current/development/build-instructions.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/i18n/es-ES/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/es-ES/docusaurus-plugin-content-docs/current/development/build-instructions.md index e993b9899..05dc3d903 100644 --- a/i18n/es-ES/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/es-ES/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,8 +12,6 @@ Se requieren los siguientes paquetes de software: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Lea la sección [Instrucciones completas](#full-instructions) para obtener una explicación completa de cómo instalar todo el software necesario y cómo compilar UMS para cada sistema operativo. - # Instrucciones cortas Si se han instalado todos los paquetes de software requeridos, los siguientes comandos descargarán el código fuente más reciente y la compilación UMS: From eacd3d136e2694294a0cdd9ed0317c467c57693f Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:27 +1200 Subject: [PATCH 07/84] New translations development.md (Spanish) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/es-ES/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/es-ES/docusaurus-plugin-content-docs/current/development/development.md b/i18n/es-ES/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/es-ES/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From c092250fd925af2ddf493851a13b7cf9f0c2e200 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:29 +1200 Subject: [PATCH 08/84] New translations build-instructions.md (Afrikaans) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/af-ZA/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/af-ZA/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/af-ZA/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/af-ZA/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From 85e631958ee684c9dc75755131739ba4984ec43a Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:30 +1200 Subject: [PATCH 09/84] New translations development.md (Afrikaans) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/af-ZA/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/af-ZA/docusaurus-plugin-content-docs/current/development/development.md b/i18n/af-ZA/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/af-ZA/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From bf5be8c524eacd4f3c28ffbba9430026e98ff0a1 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:32 +1200 Subject: [PATCH 10/84] New translations build-instructions.md (Arabic) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/ar-SA/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/ar-SA/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/ar-SA/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/ar-SA/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From b360bd054e8864641b9f4ff6f6920fb0ab2a68e4 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:33 +1200 Subject: [PATCH 11/84] New translations development.md (Arabic) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/ar-SA/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/ar-SA/docusaurus-plugin-content-docs/current/development/development.md b/i18n/ar-SA/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/ar-SA/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 7aa31f1e56b5d4e1830d4041ffca0159665ed865 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:35 +1200 Subject: [PATCH 12/84] New translations build-instructions.md (Bulgarian) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/bg-BG/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/bg-BG/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/bg-BG/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/bg-BG/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From 83bb99836aabc50fe7240f6c6d74d933deea1cd3 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:36 +1200 Subject: [PATCH 13/84] New translations development.md (Bulgarian) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/bg-BG/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/bg-BG/docusaurus-plugin-content-docs/current/development/development.md b/i18n/bg-BG/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/bg-BG/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 2c85515153eeda00b23a174723cf569d00f3a38c Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:38 +1200 Subject: [PATCH 14/84] New translations build-instructions.md (Catalan) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/ca-ES/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/ca-ES/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/ca-ES/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/ca-ES/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From 85fae4819417030cef964f65932f6c199a79f33e Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:39 +1200 Subject: [PATCH 15/84] New translations development.md (Catalan) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/ca-ES/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/ca-ES/docusaurus-plugin-content-docs/current/development/development.md b/i18n/ca-ES/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/ca-ES/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 4e4c606ccca92b5abb7238133a08863048c88653 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:41 +1200 Subject: [PATCH 16/84] New translations build-instructions.md (Czech) [ci skip] --- .../current/development/build-instructions.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/i18n/cs-CZ/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/cs-CZ/docusaurus-plugin-content-docs/current/development/build-instructions.md index ccf457923..2f8cf265b 100644 --- a/i18n/cs-CZ/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/cs-CZ/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,8 +12,6 @@ Jsou vyžadovány následující balíčky programů: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -V sekci [plné instrukce] (#full-instructions) najdete kompletní vysvětlení jak instalovat všechen potřebný software a jak vytvořit UMS pro každý operační systém. - # Krátké pokyny Pokud jsou nainstalovány všechny požadované balíky, následující příkazy From eb17ef13bed7534ef2b887725eb0481f6dcdba9e Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:42 +1200 Subject: [PATCH 17/84] New translations development.md (Czech) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/cs-CZ/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/cs-CZ/docusaurus-plugin-content-docs/current/development/development.md b/i18n/cs-CZ/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/cs-CZ/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From c6f7c500ffe4319fb757c56467b33dde94ed6e9a Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:44 +1200 Subject: [PATCH 18/84] New translations build-instructions.md (Danish) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/da-DK/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/da-DK/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/da-DK/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/da-DK/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From 2b74462b1072dd136cea1967e590a5fa28ba8e72 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:45 +1200 Subject: [PATCH 19/84] New translations development.md (Danish) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/da-DK/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/da-DK/docusaurus-plugin-content-docs/current/development/development.md b/i18n/da-DK/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/da-DK/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From a1b169c1f708d1a333ff6ebea1ca53657a34648b Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:46 +1200 Subject: [PATCH 20/84] New translations build-instructions.md (German) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/de-DE/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/de-DE/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/de-DE/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/de-DE/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From 5abf8d92b1c08cb78c96987de7e76447479c9b6c Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:48 +1200 Subject: [PATCH 21/84] New translations development.md (German) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/de-DE/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/de-DE/docusaurus-plugin-content-docs/current/development/development.md b/i18n/de-DE/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/de-DE/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 5bcaa575480971150367f39145e35cabda4134dc Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:49 +1200 Subject: [PATCH 22/84] New translations build-instructions.md (Greek) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/el-GR/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/el-GR/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/el-GR/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/el-GR/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From 28624bc89eabcdf414fb707e35e1142cd38ad4b1 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:51 +1200 Subject: [PATCH 23/84] New translations development.md (Greek) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/el-GR/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/el-GR/docusaurus-plugin-content-docs/current/development/development.md b/i18n/el-GR/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/el-GR/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 443bc13695dfe8fcaad1aaa7cebf67881ce18075 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:52 +1200 Subject: [PATCH 24/84] New translations build-instructions.md (Finnish) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/fi-FI/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/fi-FI/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/fi-FI/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/fi-FI/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From 89e1ea4c615a4c5d2e4e5716e19d28b8573e268c Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:54 +1200 Subject: [PATCH 25/84] New translations development.md (Finnish) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/fi-FI/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/fi-FI/docusaurus-plugin-content-docs/current/development/development.md b/i18n/fi-FI/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/fi-FI/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 56b7bfadd17e1d37468353b1414e2bc4a5324513 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:55 +1200 Subject: [PATCH 26/84] New translations build-instructions.md (Hebrew) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/he-IL/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/he-IL/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/he-IL/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/he-IL/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From f838f51a43e474ee5d3610d2d588998dfc59767d Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:57 +1200 Subject: [PATCH 27/84] New translations development.md (Hebrew) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/he-IL/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/he-IL/docusaurus-plugin-content-docs/current/development/development.md b/i18n/he-IL/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/he-IL/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 49ecdef003bccc6b5fca2238bf56b79e6b92928b Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:34:58 +1200 Subject: [PATCH 28/84] New translations build-instructions.md (Hungarian) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/hu-HU/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/hu-HU/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/hu-HU/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/hu-HU/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From afb63471a38605c853113bf2ae7ca09f20ddeb95 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:00 +1200 Subject: [PATCH 29/84] New translations development.md (Hungarian) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/hu-HU/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/hu-HU/docusaurus-plugin-content-docs/current/development/development.md b/i18n/hu-HU/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/hu-HU/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From f04a8c4c49ae7b7a3cd882f3c8a579431441ce06 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:01 +1200 Subject: [PATCH 30/84] New translations build-instructions.md (Italian) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/it-IT/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/it-IT/docusaurus-plugin-content-docs/current/development/build-instructions.md index 8e2682933..e616e2c08 100644 --- a/i18n/it-IT/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/it-IT/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From 7126ba3a4a59cb75d21ba8670cc0cec13b0b170f Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:03 +1200 Subject: [PATCH 31/84] New translations development.md (Italian) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/it-IT/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/it-IT/docusaurus-plugin-content-docs/current/development/development.md b/i18n/it-IT/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/it-IT/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 607247c77757b7f8e1d5ca46f61d0f315c180f5d Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:05 +1200 Subject: [PATCH 32/84] New translations build-instructions.md (Japanese) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/ja-JP/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/ja-JP/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/ja-JP/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/ja-JP/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From f3269c9599db2cb6d7ada43e0310665bd7a874f6 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:06 +1200 Subject: [PATCH 33/84] New translations development.md (Japanese) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/ja-JP/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/ja-JP/docusaurus-plugin-content-docs/current/development/development.md b/i18n/ja-JP/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/ja-JP/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From b5d22f9df1e8b09a4485566a4cdd6a8f6eac5278 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:07 +1200 Subject: [PATCH 34/84] New translations build-instructions.md (Korean) [ci skip] --- .../current/development/build-instructions.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/i18n/ko-KR/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/ko-KR/docusaurus-plugin-content-docs/current/development/build-instructions.md index 566e313a0..d2665bdb3 100644 --- a/i18n/ko-KR/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/ko-KR/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,8 +12,6 @@ _중요한 참고 사항:_: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -필요한 모든 소프트웨어를 설치하는 방법과 각 운영 체제에 맞는 UMS를 구축하는 방법에 대한 자세한 설명은 [전체 지침](#전체 지침) 섹션을 읽어보세요. - # 짧은 지침 모든 필수 소프트웨어 패키지가 설치되면 다음 명령어가 최신 소스를 다운로드하고 UMS를 구축합니다: From 573c6e69160555822fd76225b4887a36dddba0d1 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:09 +1200 Subject: [PATCH 35/84] New translations development.md (Korean) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/ko-KR/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/ko-KR/docusaurus-plugin-content-docs/current/development/development.md b/i18n/ko-KR/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/ko-KR/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 6950f3e5e45cbcb05cfd053fec83160c07ed2475 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:11 +1200 Subject: [PATCH 36/84] New translations build-instructions.md (Dutch) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/nl-NL/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/nl-NL/docusaurus-plugin-content-docs/current/development/build-instructions.md index 9e691fb0d..931662af6 100644 --- a/i18n/nl-NL/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/nl-NL/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ De volgende softwarepakketten zijn vereist: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Lees de [Volledige instructies] (#full-instructions) sectie voor een volledige uitleg over hoe je -alle benodigde software installeert en hoe je UMS voor elk besturingssysteem kunt bouwen. - # Korte instructies Als alle benodigde softwarepakketten zijn geïnstalleerd, zullen de volgende commando's From 2dfdabf7726f6d19d9a175577b3e6f1bf14602d7 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:12 +1200 Subject: [PATCH 37/84] New translations development.md (Dutch) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/nl-NL/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/nl-NL/docusaurus-plugin-content-docs/current/development/development.md b/i18n/nl-NL/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/nl-NL/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From fa273b402e1fa0160dce906c67db7cce5b2d5f1f Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:14 +1200 Subject: [PATCH 38/84] New translations build-instructions.md (Norwegian) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/no-NO/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/no-NO/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/no-NO/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/no-NO/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From e0b2cac1853ac7b578dcdda84b1f423b75243d12 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:15 +1200 Subject: [PATCH 39/84] New translations development.md (Norwegian) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/no-NO/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/no-NO/docusaurus-plugin-content-docs/current/development/development.md b/i18n/no-NO/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/no-NO/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 630734a09a93ee4ddc69e07ac95a5283c7598ee1 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:17 +1200 Subject: [PATCH 40/84] New translations build-instructions.md (Polish) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/pl-PL/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/pl-PL/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/pl-PL/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/pl-PL/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From 2c51147fcaa2a85bd833bc8cdf177a8e7431297f Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:18 +1200 Subject: [PATCH 41/84] New translations development.md (Polish) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/pl-PL/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/pl-PL/docusaurus-plugin-content-docs/current/development/development.md b/i18n/pl-PL/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/pl-PL/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From ba7d31a3037f0bb5382177a5f8c2fa2cdc94d7f2 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:20 +1200 Subject: [PATCH 42/84] New translations build-instructions.md (Portuguese) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/pt-PT/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/pt-PT/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/pt-PT/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/pt-PT/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From 84f752d3ef071bc54586bc75e1f01b1c2621fc20 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:21 +1200 Subject: [PATCH 43/84] New translations development.md (Portuguese) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/pt-PT/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/pt-PT/docusaurus-plugin-content-docs/current/development/development.md b/i18n/pt-PT/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/pt-PT/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 2365a41affdac3896b1d92952881f0efd166a4a9 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:23 +1200 Subject: [PATCH 44/84] New translations build-instructions.md (Russian) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/ru-RU/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/ru-RU/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/ru-RU/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/ru-RU/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From bac28bddeb5e1d28d4775d63caa0bb25ba8b391c Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:24 +1200 Subject: [PATCH 45/84] New translations development.md (Russian) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/ru-RU/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/ru-RU/docusaurus-plugin-content-docs/current/development/development.md b/i18n/ru-RU/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/ru-RU/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From cb130813cfe30c93a07d2b305716a314b78b5908 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:26 +1200 Subject: [PATCH 46/84] New translations build-instructions.md (Slovak) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/sk-SK/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/sk-SK/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/sk-SK/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/sk-SK/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From f45c1c8a52eeadd5c22a707ce556dd365f8936a2 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:27 +1200 Subject: [PATCH 47/84] New translations development.md (Slovak) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/sk-SK/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/sk-SK/docusaurus-plugin-content-docs/current/development/development.md b/i18n/sk-SK/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/sk-SK/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From db6729ab643e6542c1ad768d746829d689fc6de9 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:29 +1200 Subject: [PATCH 48/84] New translations build-instructions.md (Slovenian) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/sl-SI/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/sl-SI/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/sl-SI/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/sl-SI/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From a8df1ab5050208a014152c85a478181f0400249a Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:30 +1200 Subject: [PATCH 49/84] New translations development.md (Slovenian) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/sl-SI/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/sl-SI/docusaurus-plugin-content-docs/current/development/development.md b/i18n/sl-SI/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/sl-SI/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 9d7986c04992ce2c8d6cf812de4e136bd7c471f7 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:32 +1200 Subject: [PATCH 50/84] New translations build-instructions.md (Serbian (Cyrillic)) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/sr-SP/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/sr-SP/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/sr-SP/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/sr-SP/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From 43860f33f616d0ec72e3706ffb054598c7e7b2b1 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:33 +1200 Subject: [PATCH 51/84] New translations development.md (Serbian (Cyrillic)) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/sr-SP/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/sr-SP/docusaurus-plugin-content-docs/current/development/development.md b/i18n/sr-SP/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/sr-SP/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 7f952f971b805f461486f9de03c83205eb9e18df Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:35 +1200 Subject: [PATCH 52/84] New translations build-instructions.md (Swedish) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/sv-SE/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/sv-SE/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/sv-SE/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/sv-SE/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From 3f49f6271966f1d36a1c9fe2ce6b0a3738f7a921 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:36 +1200 Subject: [PATCH 53/84] New translations development.md (Swedish) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/sv-SE/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/sv-SE/docusaurus-plugin-content-docs/current/development/development.md b/i18n/sv-SE/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/sv-SE/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 709f4f48736d57b6f941e4ba2304abe9691014e9 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:38 +1200 Subject: [PATCH 54/84] New translations build-instructions.md (Turkish) [ci skip] --- .../current/development/build-instructions.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/i18n/tr-TR/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/tr-TR/docusaurus-plugin-content-docs/current/development/build-instructions.md index ec17f381e..bd02fae65 100644 --- a/i18n/tr-TR/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/tr-TR/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,8 +12,6 @@ Aşağıdaki yazılım paketleri gerekir: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Gerekli tüm yazılımların nasıl yükleneceğini ve her işletim sistemi için UMS’nin nasıl oluşturulacağına ilişkin tam bir açıklama için [Tam talimatlar](#full-instructions) bölümünü okuyun. - # Kısa talimatlar Eğer gerekli tüm yazılım paketleri yüklüyse aşağıdaki komutlar en son kaynakları indirecek ve UMS’yi oluşturacaktır: From 96ab9d795f761040e51fd06e9ecbdd12200c7c6e Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:39 +1200 Subject: [PATCH 55/84] New translations development.md (Turkish) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/tr-TR/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/tr-TR/docusaurus-plugin-content-docs/current/development/development.md b/i18n/tr-TR/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/tr-TR/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From e657fe48e8c2cccc55c3cb0dfd73c2d8dd9bc0a5 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:41 +1200 Subject: [PATCH 56/84] New translations build-instructions.md (Ukrainian) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/uk-UA/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/uk-UA/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/uk-UA/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/uk-UA/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From 5efaf3898c32526aebf618153a5053c69675aabf Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:42 +1200 Subject: [PATCH 57/84] New translations development.md (Ukrainian) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/uk-UA/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/uk-UA/docusaurus-plugin-content-docs/current/development/development.md b/i18n/uk-UA/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/uk-UA/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From a7fa3ce09a45634aa1fcea0948cca6153c0ecdd3 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:44 +1200 Subject: [PATCH 58/84] New translations build-instructions.md (Chinese Simplified) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From a650f206f0dfce363fc1ffb3f68cea84a4f7dced Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:45 +1200 Subject: [PATCH 59/84] New translations development.md (Chinese Simplified) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/zh-CN/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/development/development.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 1fcae1d3e8b3507c957566984506881a798bcf95 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:47 +1200 Subject: [PATCH 60/84] New translations build-instructions.md (Chinese Traditional) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From 0d7ad1fcddaadffe5f680cdd85ab2b0b1cc254f1 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:48 +1200 Subject: [PATCH 61/84] New translations development.md (Chinese Traditional) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/zh-TW/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/development/development.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 00544850c41f85fe9775e052b1d74b1e22afc64b Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:50 +1200 Subject: [PATCH 62/84] New translations build-instructions.md (Vietnamese) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/vi-VN/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/vi-VN/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/vi-VN/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/vi-VN/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From 0ef9e7a3342042159c3402d590275a373c2cbe7e Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:51 +1200 Subject: [PATCH 63/84] New translations development.md (Vietnamese) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/vi-VN/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/vi-VN/docusaurus-plugin-content-docs/current/development/development.md b/i18n/vi-VN/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/vi-VN/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 4f293ef2594b250a90bbf92f416959a4ca3527e3 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:53 +1200 Subject: [PATCH 64/84] New translations build-instructions.md (Icelandic) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/is-IS/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/is-IS/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/is-IS/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/is-IS/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From a1ada948840a0f9612f7acf2e66526773428ea83 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:55 +1200 Subject: [PATCH 65/84] New translations development.md (Icelandic) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/is-IS/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/is-IS/docusaurus-plugin-content-docs/current/development/development.md b/i18n/is-IS/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/is-IS/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 9c661a866f42dc93f029d82907b542ce7533b963 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:56 +1200 Subject: [PATCH 66/84] New translations build-instructions.md (Portuguese, Brazilian) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/development/build-instructions.md index 2a6616dac..9352e658f 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ Os seguintes pacotes de software são necessários: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From b087f43878f687b3b224c86ae2ea5eec7e95f98c Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:58 +1200 Subject: [PATCH 67/84] New translations development.md (Portuguese, Brazilian) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/pt-BR/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/development/development.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From dd40d03f262711d33491db353e3729225d8c8552 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:35:59 +1200 Subject: [PATCH 68/84] New translations build-instructions.md (Persian) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/fa-IR/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/fa-IR/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/fa-IR/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/fa-IR/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From a32d1548efe4f19ed81a699d867249f951833fff Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:36:01 +1200 Subject: [PATCH 69/84] New translations development.md (Persian) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/fa-IR/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/fa-IR/docusaurus-plugin-content-docs/current/development/development.md b/i18n/fa-IR/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/fa-IR/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 7671a1fe0e3c7e94e4290d0db174b2f140031178 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:36:02 +1200 Subject: [PATCH 70/84] New translations build-instructions.md (Croatian) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/hr-HR/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/hr-HR/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/hr-HR/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/hr-HR/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From 27541bdfda32caa8daa65abab2c32962092e0e21 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:36:04 +1200 Subject: [PATCH 71/84] New translations development.md (Croatian) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/hr-HR/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/hr-HR/docusaurus-plugin-content-docs/current/development/development.md b/i18n/hr-HR/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/hr-HR/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From a7153a70d2da8f98d7381fefe59a5802ddc54593 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:36:05 +1200 Subject: [PATCH 72/84] New translations build-instructions.md (Estonian) [ci skip] --- .../current/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/i18n/et-EE/docusaurus-plugin-content-docs/current/development/build-instructions.md b/i18n/et-EE/docusaurus-plugin-content-docs/current/development/build-instructions.md index 06750a823..3560deab0 100644 --- a/i18n/et-EE/docusaurus-plugin-content-docs/current/development/build-instructions.md +++ b/i18n/et-EE/docusaurus-plugin-content-docs/current/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: - Maven - [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From 47ea2a22ffc68ee58f48db89d45e9526328dd43e Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:36:07 +1200 Subject: [PATCH 73/84] New translations development.md (Estonian) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/et-EE/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/et-EE/docusaurus-plugin-content-docs/current/development/development.md b/i18n/et-EE/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/et-EE/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 767a643e478376e0dd904bb060fabd67adffa870 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 22:36:08 +1200 Subject: [PATCH 74/84] New translations development.md (English, United Kingdom) [ci skip] --- .../current/development/development.md | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 i18n/en-GB/docusaurus-plugin-content-docs/current/development/development.md diff --git a/i18n/en-GB/docusaurus-plugin-content-docs/current/development/development.md b/i18n/en-GB/docusaurus-plugin-content-docs/current/development/development.md new file mode 100644 index 000000000..d4bb8692e --- /dev/null +++ b/i18n/en-GB/docusaurus-plugin-content-docs/current/development/development.md @@ -0,0 +1,101 @@ +# Development + +This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +- [Set up your machine for GitHub development](https://support.github.com/) + +- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +- Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +- Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +- In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +- Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +- Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +- Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 92218d851ad506b7ebe2268f7552479e1e5cfc52 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 23:30:51 +1200 Subject: [PATCH 75/84] Update source file build-instructions.md [ci skip] --- docs/development/build-instructions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/docs/development/build-instructions.md b/docs/development/build-instructions.md index 8cb30a0dc..3d90b574c 100644 --- a/docs/development/build-instructions.md +++ b/docs/development/build-instructions.md @@ -12,9 +12,6 @@ The following software packages are required: * Maven * [MediaInfo](https://mediaarea.net/en/MediaInfo/Download) -Read the [Full instructions](#full-instructions) section for a complete explanation of how to -install all required software and how to build UMS for each operating system. - # Short instructions If all required software packages are installed, the following commands will From 89787110627a47d7c1e3c00751d9bc7deb80f82b Mon Sep 17 00:00:00 2001 From: SubJunk Date: Fri, 29 May 2026 23:30:52 +1200 Subject: [PATCH 76/84] Update source file development.md [ci skip] --- docs/development/development.md | 101 ++++++++++++++++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 docs/development/development.md diff --git a/docs/development/development.md b/docs/development/development.md new file mode 100644 index 000000000..f583ad71c --- /dev/null +++ b/docs/development/development.md @@ -0,0 +1,101 @@ +# Development + + This document explains how to make and run your own changes. + +## Forking the code to your machine + +GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. + +* [Set up your machine for GitHub development](https://support.github.com/) + +* Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. + +* Clone the new GitHub repo to your local machine. The clone URL can be seen + on the main page of your repository. It should be something like this + (replace YOURNAME with your actual GitHub name): + + git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + +You now have the new repository on your local machine. + +## Development with IDEs + +### [VS Code](https://code.visualstudio.com/) + +This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. + +#### Java server + +When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. +When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. + +#### Web browser interfaces + +If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. + +In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. + +For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. + +For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. + +### [Eclipse](http://www.eclipse.org/downloads/) + +* Install the m2e Eclipse plugin (http://eclipse.org/m2e/) + +* Install the EGit Eclipse plugin (http://eclipse.org/egit/) + +* In Eclipse, select the menu "Window > Show View > Git Repositories". Then + select "Window > Navigation > Show View Menu", choose "Add a Repository". + Browse for the directory where you cloned your repository and press the + "Search" button. Select your forked repository and press "OK". + The repository should appear in the Git Repositories view. + +* Press the right mouse button on the repository and select "Import Maven + Projects" from the menu. Select the project "/pom.xml" and press "Finish". + + Note: if a project with the same name already exists, click "Advanced" and + set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with + your GitHub name). Then press "Finish". + +You now see the sources in Eclipse, but the project is still missing the "Git" +nature. In other words, it is not tied to the local repository yet. This means +you cannot perform any Git actions from Eclipse yet. Add the missing connection +by sharing the project: + +* Press the right mouse button on the newly created project and select the + menu "Team > Share Project...". Select "Git" and press "Next >". + Check the checkbox "Use or create repository in parent folder of project" + and make sure the project is selected. Then press "Finish". + +Verify that your project is now under Git control. Press the right mouse +button on the project and under "Team" you now see all options to work with +Git. + +You can build UMS from Eclipse: + +* Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: + `package`. Select the tab "JRE" and add the following VM arguments + `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. + +You will want to run UMS from Eclipse while developing. This is how you do it: + +* Create a new run configuration under "Run > Run Configurations...", right + mouse button on "Maven Build", select "New", Name: `Run UMS`, Base + directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. + Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. + Finally, press the "Apply" button. + +You are now ready to start developing! + +When you are happy with your changes, you can commit them to your local +repository from Eclipse using right mouse button, "Team > Commit...". + +When you are satisfied with your commits and want to publish them to your +repository at GitHub, you can press the right mouse button on the project and +select "Team > Push to Upstream". + +## Contributing your change back to us + +If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file From 9bfc7b640be0229bf8f5d11d65e381e6d7055f1d Mon Sep 17 00:00:00 2001 From: SubJunk Date: Sat, 30 May 2026 04:35:05 +1200 Subject: [PATCH 77/84] New translations security-and-privacy.md (Chinese Simplified) [ci skip] --- .../current/configuration/security-and-privacy.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/configuration/security-and-privacy.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/configuration/security-and-privacy.md index 1b4b3e941..1b0c900a0 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/configuration/security-and-privacy.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/configuration/security-and-privacy.md @@ -8,9 +8,9 @@ UMS主要通过两种方式提供媒体服务——通过DLNA/UPnP供媒体播 媒体播放器应用通常不支持“用户”概念，因此，一般而言每台设备都会获取相同的内容。 这可能不是你想要的。 例如，如果你有两个文件夹 kids_safe 和 kids_unsafe，你可能想要限制儿童房中的渲染器，使其只能访问 kids_safe 文件夹。 另一种常见情况是，你和不想让其访问你媒体的人（例如室友）处于同一网络，因此你想要完全屏蔽某些渲染器。 -UMS provides a number of methods to control access in those situations. +UMS 提供了多种方法来控制这些情况下的访问。 -## Allow or block renderers or network devices by default +## 默认允许或阻止渲染器或网络设备 You can choose the default strategy for renderers and network devices. You can allow or deny by default, with denylists and allowlists, for complete control. This is useful for shared living situations or wide/low-trust local networks. It is also useful for those of you using powerline adapters for your network since that can result in unwanted access from neighbors. From 7fdc1fc997513f6cb9aa319924e9156624ba7b4c Mon Sep 17 00:00:00 2001 From: SubJunk Date: Sat, 30 May 2026 05:38:47 +1200 Subject: [PATCH 78/84] New translations security-and-privacy.md (Chinese Simplified) [ci skip] --- .../current/configuration/security-and-privacy.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/configuration/security-and-privacy.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/configuration/security-and-privacy.md index 1b0c900a0..a7956717c 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/configuration/security-and-privacy.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/configuration/security-and-privacy.md @@ -11,17 +11,17 @@ UMS主要通过两种方式提供媒体服务——通过DLNA/UPnP供媒体播 UMS 提供了多种方法来控制这些情况下的访问。 ## 默认允许或阻止渲染器或网络设备 -You can choose the default strategy for renderers and network devices. You can allow or deny by default, with denylists and allowlists, for complete control. +你可以为渲染器和网络设备选择默认策略。 你可以默认允许或拒绝，配合黑名单和白名单，实现完全控制。 -This is useful for shared living situations or wide/low-trust local networks. It is also useful for those of you using powerline adapters for your network since that can result in unwanted access from neighbors. +这对于合住环境或广泛/低信任度的本地网络非常有用。 对于使用电力线适配器搭建网络的用户也很有用，因为这可能导致来自邻居的意外访问。 -![Example of how to set network allow preference](@site/docs/img/whats-new-in-v14-network-allowblock-preference.png) +![设置网络允许偏好的示例](@site/docs/img/whats-new-in-v14-network-allowblock-preference.png) -![Example of how to set renderer allow preference](@site/docs/img/whats-new-in-v14-renderer-allow-preference.png) +![设置渲染器允许偏好的示例](@site/docs/img/whats-new-in-v14-renderer-allow-preference.png) -## Block/allow renderers and network devices +## 阻止/允许渲染器和网络设备 -When you have chosen whether to allow or block unrecognized renderers by default, you can build your denylist or allowlist from the Home screen in the settings area. +当你选定了默认允许还是阻止未识别的渲染器后，就可以在设置区域的主屏幕上构建黑名单或白名单。 ![Example of how to block a renderer](@site/docs/img/whats-new-in-v14-block-renderer.png) From b13ad541bd116203e5e0da205ec31bef5f2ff858 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Sat, 30 May 2026 07:40:23 +1200 Subject: [PATCH 79/84] New translations development.md (Turkish) [ci skip] --- .../current/development/development.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/tr-TR/docusaurus-plugin-content-docs/current/development/development.md b/i18n/tr-TR/docusaurus-plugin-content-docs/current/development/development.md index d4bb8692e..a6e079eb9 100644 --- a/i18n/tr-TR/docusaurus-plugin-content-docs/current/development/development.md +++ b/i18n/tr-TR/docusaurus-plugin-content-docs/current/development/development.md @@ -1,6 +1,6 @@ -# Development +# Geliştirme -This document explains how to make and run your own changes. +Bu belge kendi değişikliklerinizi nasıl yapacağınızı ve çalıştıracağınızı açıklar. ## Forking the code to your machine From 7ae79af31e4bf8683c38d6ae65028d19307ccdaa Mon Sep 17 00:00:00 2001 From: SubJunk Date: Sat, 30 May 2026 09:11:47 +1200 Subject: [PATCH 80/84] New translations development.md (Dutch) [ci skip] --- .../current/development/development.md | 120 +++++++++--------- 1 file changed, 60 insertions(+), 60 deletions(-) diff --git a/i18n/nl-NL/docusaurus-plugin-content-docs/current/development/development.md b/i18n/nl-NL/docusaurus-plugin-content-docs/current/development/development.md index d4bb8692e..60a936197 100644 --- a/i18n/nl-NL/docusaurus-plugin-content-docs/current/development/development.md +++ b/i18n/nl-NL/docusaurus-plugin-content-docs/current/development/development.md @@ -1,101 +1,101 @@ -# Development +# Ontwikkeling -This document explains how to make and run your own changes. +Dit document legt uit hoe u uw eigen wijzigingen kan maken en uitvoeren. -## Forking the code to your machine +## Forking de code naar je machine -GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. +GitHub maakt het heel eenvoudig voor ontwikkelaars om hun eigen versie van de officiële UMS-bronnen te forken om hun eigen aanpassingen of functies toe te voegen. GitHub vergemakkelijkt het indienen van deze functies als "Pull Requests" aan het officiële UMS ontwikkelteam. -- [Set up your machine for GitHub development](https://support.github.com/) +- [Uw machine instellen voor GitHub ontwikkeling](https://support.github.com/) -- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. +- Ga naar [de GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) en druk op de `Fork` knop rechtsboven. -- Clone the new GitHub repo to your local machine. The clone URL can be seen - on the main page of your repository. It should be something like this - (replace YOURNAME with your actual GitHub name): +- Kloon de nieuwe GitHub repo naar je lokale machine. De URL van de kloon kan gezien worden + op de hoofdpagina van uw opslagplaats. Het zou zoiets moeten zijn als dit + (vervang YOURNAME met je echte GitHub naam): git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME -You now have the new repository on your local machine. +Je hebt nu de nieuwe repository op je lokale machine. -## Development with IDEs +## Ontwikkeling met IDEs ### [VS Code](https://code.visualstudio.com/) -This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. +Dit is onze aanbevolen editor omdat het geweldig is in het verwerken van zowel Java als TypeScript, onze twee hoofdtalen. #### Java server -When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. -When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. +Wanneer je de code hebt geopend, zie je waarschijnlijk enkele aanbevelingen voor Extensies om te installeren, zoals het `Extensie Pack voor Java`. Installeer deze/ze. +Wanneer dat is geïnstalleerd en geconfigureerd, kunt u de Java server uitvoeren door op de top `Run -> Start Debugging` te klikken, en herlaad het met `Run -> Herstart Debugging`. Deze commando's moeten binnen 1 seconde voltooid zijn, voor een snelle ontwikkeling workflow. -#### Web browser interfaces +#### Webbrowser interfaces -If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. +Als u wijzigingen wilt aanbrengen in onze webbrowserinterfaces, moet u ook de React server runnen. welke zal zorgen voor het compileren en bedienen van de TypeScript code. -In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files. +In VS Code kun je naar de `Command Palette` gaan en filteren op `Debug: Selecteer en Start Debugging` en selecteer `Start web interface`. Het zal alle wijzigingen die u aanbrengt in de React bestanden automatisch herladen. -For a manual workflow, you can go into the `react-client` folder and run `yarn` to download the necessary dependencies. Then just run `yarn dev` which should open the web player in the browser and automatically compile any code changes you make. +Voor een handmatige workflow, kunt u naar de `react-client` map gaan en `yarn` starten om de benodigde afhankelijkheden te downloaden. Voer dan `yarn dev` uit die de webspeler in de browser moet openen en automatisch codewijzigingen moet compileren. -For the web settings interface, you can open `react-client/package.json` and change the proxy port from `9002` to `9001`. Now `yarn dev` should serve the web settings instead of web player. +Voor de webinstellingen interface kunt u `react-client/package.json` openen en de proxypoort veranderen van `9002` naar `9001`. Nu `yarn dev` moet de webinstellingen gebruiken in plaats van de webspeler. ### [Eclipse](http://www.eclipse.org/downloads/) -- Install the m2e Eclipse plugin (http://eclipse.org/m2e/) +- Installeer de m2e Eclipse plugin (http://eclipse.org/m2e/) -- Install the EGit Eclipse plugin (http://eclipse.org/egit/) +- Installeer de EGit Eclipse plugin (http://eclipse.org/egit/) -- In Eclipse, select the menu "Window > Show View > Git Repositories". Then - select "Window > Navigation > Show View Menu", choose "Add a Repository". - Browse for the directory where you cloned your repository and press the - "Search" button. Select your forked repository and press "OK". - The repository should appear in the Git Repositories view. +- Selecteer in het Eclipse menu "Venster > Weergeven > Git Repositories". Selecteer dan + "Venster > Navigatie > Toon Menu" en kies "Voeg een Repository toe". + Blader naar de map waar u uw repository heeft gekloond en druk op de + "Zoeken". Selecteer uw geforkte repository en druk op "OK". + De repository moet in het overzicht van de Git Repositories verschijnen. -- Press the right mouse button on the repository and select "Import Maven - Projects" from the menu. Select the project "/pom.xml" and press "Finish". +- Druk op de rechtermuisknop in de repository en selecteer "Importeer Maven + Projecten" in het menu. Selecteer het project "/pom.xml" en druk op "Voltooien". - Note: if a project with the same name already exists, click "Advanced" and - set the "Name template" to `[artifactId]-YOURNAME` (replace YOURNAME with - your GitHub name). Then press "Finish". + Opmerking: als een project met dezelfde naam al bestaat Klik op "Geavanceerd" en + zet het "Naam sjabloon" op "[artifactId]- JOUW NAAM" (vervang JOUW met + je GitHub naam). Druk vervolgens op "Voltooien". -You now see the sources in Eclipse, but the project is still missing the "Git" -nature. In other words, it is not tied to the local repository yet. This means -you cannot perform any Git actions from Eclipse yet. Add the missing connection -by sharing the project: +Je ziet nu de bronnen in Eclipse, maar het project mist nog steeds de aard "Git" +. Met andere woorden, het is nog niet gekoppeld aan de lokale repository. Dit betekent +dat u nog geen Git acties van Eclipse kunt uitvoeren. Voeg de ontbrekende verbinding +toe door het project te delen: -- Press the right mouse button on the newly created project and select the - menu "Team > Share Project...". Select "Git" and press "Next >". - Check the checkbox "Use or create repository in parent folder of project" - and make sure the project is selected. Then press "Finish". +- Druk op de rechtermuisknop op het nieuw aangemaakte project en selecteer het + menu "Team > Deel Project...". Selecteer "Git" en druk op "Next >". + Vink het selectievakje "Gebruik of maak repository aan in de bovenliggende map van project" + en zorg ervoor dat het project is geselecteerd. Druk vervolgens op "Voltooien". -Verify that your project is now under Git control. Press the right mouse -button on the project and under "Team" you now see all options to work with +Controleer of uw project nu onder Git controle is. Druk op de rechtermuisknop +op het project en onder "Team" zie je nu alle opties om te werken met Git. -You can build UMS from Eclipse: +U kunt UMS bouwen vanuit Eclipse: -- Create a new run configuration under "Run > Run Configurations...", right - mouse button on "Maven Build", select "New", Name: `Build UMS`, Goals: - `package`. Select the tab "JRE" and add the following VM arguments - `-Xmx1500m -XX:MaxPermSize=256m`. Finally, press the "Apply" button. +- Maak een nieuwe run configuratie onder "Run > Configuraties uitvoeren...", rechter + muisknop op "Maven Build", selecteer "Nieuw", Naam: `Build UMS`, Goals: + `package`. Selecteer het tabblad "JRE" en voeg de volgende VM argumenten toe + `-Xmx1500m -XX:MaxPermSize=256m`. Druk tenslotte op de knop "Toepassen". -You will want to run UMS from Eclipse while developing. This is how you do it: +Je wilt UMS uitvoeren vanaf Eclipse tijdens de ontwikkeling. Zo doe je het: -- Create a new run configuration under "Run > Run Configurations...", right - mouse button on "Maven Build", select "New", Name: `Run UMS`, Base - directory: `${project_loc}`, Goals: "test", Profiles: `run-from-eclipse`. - Select the tab "JRE" and add VM arguments `-Xmx1500m -XX:MaxPermSize=256m`. - Finally, press the "Apply" button. +- Maak een nieuwe run configuratie onder "Run > Configuratie Uitvoeren... , rechter + muisknop op "Maven Build", selecteer "Nieuw", Naam: `Run UMS`, Basis + directory: `${project_loc}`, Bestemming: "test", Profiles: `run-from-eclipse`. + Selecteer het tabblad "JRE" en voeg VM-argumenten "-Xmx1500m -XX:MaxPermSize=256m" toe. + Druk tenslotte op de knop "Toepassen". -You are now ready to start developing! +Je bent nu klaar om te beginnen met ontwikkelen! -When you are happy with your changes, you can commit them to your local -repository from Eclipse using right mouse button, "Team > Commit...". +Wanneer je tevreden bent met je wijzigingen, kun je deze toewijzen aan je lokale +repository van Eclipse met behulp van de rechtermuisknop, "Team > Commit...". -When you are satisfied with your commits and want to publish them to your -repository at GitHub, you can press the right mouse button on the project and -select "Team > Push to Upstream". +Wanneer je tevreden bent met je verwijzingen en deze wilt publiceren naar je +repository op GitHub, dan kan je op de rechter muisknop drukken op het project en +selecteer "Team > Push naar Upstream". -## Contributing your change back to us +## Geef uw wijziging terug door aan ons -If you would like to contribute to the UMS project, you can send a "Pull Request" to the development team. See [Creating a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for more details. \ No newline at end of file +Als je wilt bijdragen aan het UMS-project, kun je een "Pull request" naar het ontwikkelingsteam sturen. Zie [Een pull-aanvraag maken](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) voor meer details. \ No newline at end of file From be1fa32844ff0683254e21610e77af5cdd99751f Mon Sep 17 00:00:00 2001 From: SubJunk Date: Sat, 30 May 2026 19:41:55 +1200 Subject: [PATCH 81/84] New translations how-to-add-web-content.md (Turkish) [ci skip] --- .../current/guides/how-to-add-web-content.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/tr-TR/docusaurus-plugin-content-docs/current/guides/how-to-add-web-content.md b/i18n/tr-TR/docusaurus-plugin-content-docs/current/guides/how-to-add-web-content.md index f00d7a1b3..4f24300c2 100644 --- a/i18n/tr-TR/docusaurus-plugin-content-docs/current/guides/how-to-add-web-content.md +++ b/i18n/tr-TR/docusaurus-plugin-content-docs/current/guides/how-to-add-web-content.md @@ -34,7 +34,7 @@ Bu görüntü yayınının bağlantısıdır. Genellikle ".xml" ile biter, ancak #### Yetkili gruplar -"Yetkili gruplar" alanı, bu yayını yalnızca UMS’de tanımlanmış ve farklı kullanıcılar ve/veya cihazlarla ilişkilendirilmiş belirli gruplar tarafından kullanılabilir olmasını sağlar. Daha fazla ayrıntı için [Güvenlik ve Gizlilik](../configuration/security-and-privacy.md#link-person-to-renderer) konusuna bakın. +"Yetkili gruplar" alanı, bu yayını yalnızca UMS’de tanımlanmış ve farklı kullanıcılar ve/veya cihazlarla ilişkilendirilmiş belirli gruplar tarafından kullanılabilir olmasını sağlar. Daha fazla ayrıntı için [Güvenlik ve Gizlilik](../configuration/security-and-privacy.md#kişiyi-işleyiciye-bağlantılayın) konusuna bakın. Girdiğiniz seçeneklerden memnun olduğunuzda "Ekle" düğmesine tıklayın. From 64ead7daea4f2bb75be4684b56433301a1b6b74d Mon Sep 17 00:00:00 2001 From: SubJunk Date: Sat, 30 May 2026 20:37:15 +1200 Subject: [PATCH 82/84] New translations development.md (Turkish) [ci skip] --- .../current/development/development.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/tr-TR/docusaurus-plugin-content-docs/current/development/development.md b/i18n/tr-TR/docusaurus-plugin-content-docs/current/development/development.md index a6e079eb9..fafb22994 100644 --- a/i18n/tr-TR/docusaurus-plugin-content-docs/current/development/development.md +++ b/i18n/tr-TR/docusaurus-plugin-content-docs/current/development/development.md @@ -2,7 +2,7 @@ Bu belge kendi değişikliklerinizi nasıl yapacağınızı ve çalıştıracağınızı açıklar. -## Forking the code to your machine +## Kodu makinenize gönderme GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. From 32b018e9603390523407c6025b7a7118afef2770 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Sat, 30 May 2026 22:41:20 +1200 Subject: [PATCH 83/84] New translations development.md (Turkish) [ci skip] --- .../current/development/development.md | 16 +++++++--------- 1 file changed, 7 insertions(+), 9 deletions(-) diff --git a/i18n/tr-TR/docusaurus-plugin-content-docs/current/development/development.md b/i18n/tr-TR/docusaurus-plugin-content-docs/current/development/development.md index fafb22994..800ff0863 100644 --- a/i18n/tr-TR/docusaurus-plugin-content-docs/current/development/development.md +++ b/i18n/tr-TR/docusaurus-plugin-content-docs/current/development/development.md @@ -2,21 +2,19 @@ Bu belge kendi değişikliklerinizi nasıl yapacağınızı ve çalıştıracağınızı açıklar. -## Kodu makinenize gönderme +## Kodu makinenize çatallamayla ikiye ayırma -GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. +GitHub, geliştiricilerin kendi ince ayarlarını veya özelliklerini eklemek için resmi UMS kaynaklarının kendi sürümlerini çatallamalarını çok kolaylaştırır. GitHub, bu özelliklerin resmi UMS geliştirme ekibine "Çekme İstekleri" olarak gönderilmesini kolaylaştırır. -- [Set up your machine for GitHub development](https://support.github.com/) +- [GitHub geliştirme için makinenizi ayarlayın](https://support.github.com/) -- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. +- [GitHub UMS deposuna](https://github.com/universalmediaserver/universalmediaserver) gidin ve sağ üstteki `Fork` düğmesine basın. -- Clone the new GitHub repo to your local machine. The clone URL can be seen - on the main page of your repository. It should be something like this - (replace YOURNAME with your actual GitHub name): +- Yeni GitHub deposunu yerel makinenize çoğaltın. Çoğaltma URL’si deponuzun ana sayfasında görülebilir. Bu, şunun gibi bir şey olmalı (ADINIZI asıl GitHub adınızla değiştirin): - git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME + git clone git@github.com:ADINIZ/universalmediaserver.git ADINIZ -You now have the new repository on your local machine. +Artık yerel makinenizde yeni deponuz var. ## Development with IDEs From 718489b06ab30219d93e58949299e2e3bd1d22c8 Mon Sep 17 00:00:00 2001 From: SubJunk Date: Sun, 31 May 2026 04:14:38 +1200 Subject: [PATCH 84/84] New translations development.md (Czech) [ci skip] --- .../current/development/development.md | 32 +++++++++---------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/i18n/cs-CZ/docusaurus-plugin-content-docs/current/development/development.md b/i18n/cs-CZ/docusaurus-plugin-content-docs/current/development/development.md index d4bb8692e..820182cf0 100644 --- a/i18n/cs-CZ/docusaurus-plugin-content-docs/current/development/development.md +++ b/i18n/cs-CZ/docusaurus-plugin-content-docs/current/development/development.md @@ -1,37 +1,37 @@ -# Development +# Rozvoj -This document explains how to make and run your own changes. +Tento dokument vysvětluje, jak provést a spustit vlastní změny. -## Forking the code to your machine +## Stáhněte kód na svůj počítač -GitHub makes it very simple for developers to fork their own version of the official UMS sources to add their own tweaks or features. GitHub facilitates submitting these features as "Pull Requests" to the official UMS development team. +GitHub velmi zjednodušuje vývojářům oddělit svou vlastní verzi oficiálních zdrojů UMS a přidávat vlastní vylepšení nebo funkce. GitHub usnadňuje odeslání těchto funkcí jako "Pull Requests" oficiálnímu vývojovému týmu UMS. -- [Set up your machine for GitHub development](https://support.github.com/) +- [Nastavte svůj stroj pro vývoj GitHubu] (https://support.github.com/) -- Go to [the GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) and press the `Fork` button on the top right. +- Přejděte na [GitHub UMS repo](https://github.com/universalmediaserver/universalmediaserver) a stiskněte tlačítko `Fork` vpravo nahoře. -- Clone the new GitHub repo to your local machine. The clone URL can be seen - on the main page of your repository. It should be something like this +- Klonujte nový GitHub repozitář do vašeho lokálního počítače. URL klonu lze vidět + na hlavní stránce vašeho repozitáře. It should be something like this (replace YOURNAME with your actual GitHub name): git clone git@github.com:YOURNAME/universalmediaserver.git YOURNAME -You now have the new repository on your local machine. +Nyní máte nový repozitář na vašem lokálním počítači. -## Development with IDEs +## Vývoj s IDE -### [VS Code](https://code.visualstudio.com/) +### [VS kód](https://code.visualstudio.com/) -This is our recommended editor because it is great at handling both Java and TypeScript, our two main languages. +To je náš doporučený editor, protože je skvělý jak pro Javu, tak pro TypeScript, naše dva hlavní jazyky. #### Java server -When you have opened the code, you will probably see some recommendations for Extensions to install, like the `Extension Pack for Java`. Install it/them. -When that is installed and configured, you can run the Java server by clicking up the top `Run -> Start Debugging`, and reload it with `Run -> Restart Debugging`. These commands should complete within 1 second, for a fast development workflow. +Když otevřete kód, pravděpodobně uvidíte některá doporučení k instalaci rozšíření, například `Extension Pack for Java`. Nainstalujte jej. +Když je toto nainstalováno a nakonfigurováno, můžete spustit Java server kliknutím na horní tlačítko `Run -> Start Debugging`, a znovu načíst pomocí `Run -> Restart Debugging`. Tyto příkazy by měly být dokončeny do 1 sekundy pro rychlý vývojový pracovní postup. -#### Web browser interfaces +#### Webová rozhraní prohlížeče -If you want to make changes to our web browser interfaces, you will also need to run the React server, which will take care of compiling and serving the TypeScript code. +Pokud chcete provést změny v našem webovém prohlížeči, budete muset spustit React server, který se bude starat o kompilaci a obsluhu kódu TypeScript. In VS Code, you can go into the `Command Palette` and filter on `Debug: Select and Start Debugging` and select `Launch web interface`. It will automatically reload any changes you make to the React files.