Untangle is a architecture recovery & visualization tool for analyzing Java codebases, their software entities, and their internal dependencies. Untangle features no ads, tracking, cloud, server, source code pollution, and is completely open-source.
Untangle is part of a research study - please fill out our short survey after trying out the tool. Thank you!
OBS please be aware that Apple Silicon processors (M1 & M2) are not yet supported by Untangle
- View your project in either the Circular or Force-directed layouts.
- Expand and collapse packages to gain better insight into your project's hierachial structure.
- Highlight edges pertaining to a specific class / interface / package in your system by selecting nodes, and gain insights into metrics of the chosen entity.
- Control your view with filtering and hiding of unneeded elements.
| View | Image |
|---|---|
| Circular Layout |  |
| Force-directed Layout |  |
Untangle can be executed in 2 different ways - in an isolated docker container (recommended), or locally in your own environment. After having ran the application once, you can refer to rerunning Untangle for easier execution.
- A buildable maven or gradle Java project.
- Your project must be buildable with Java 8, 11, 12, 13, 14, 15, 16, or 17.
- Docker installed.
- A bit of patience, executing the analysis can take up to 10 minutes depending on your specifications.
First you must open a terminal as administrator and go to the project you wish to analyze with the command
cd ${project-to-analyze}
where ${project-to-analyze} is replaced with the path to your Java project e.g ~/Desktop/MyJavaProject
then find your operating system underneath and follow the instructions.
UNIX users can use the following command to run Untangle through docker.
curl https://raw.githubusercontent.com/Markusgp/Untangle/main/untangle.sh | bash -s -- ${java-version}
where ${java-version} should be replaced by the Java version that your project is buildable with.
For example, if you wanna run the application with Java 15 the command would be:
curl https://raw.githubusercontent.com/Markusgp/Untangle/main/untangle.sh | bash -s -- 15
Once you see the line webpack compiled with 1 warning in your terminal - Untangle is running, and can be utilized by navigating to localhost:8080 in a browser.
Windows users have to use powershell with administration rights and first enable powershell to run scripts in your current session with the following command:
PowerShell -ExecutionPolicy Bypass
Next you have to set the environment variable UNTANGLE_JAVA to a Java version that your project is buildable with, which can be done using the following command
$Env:UNTANGLE_JAVA = '${java-version}'
Now you can run the run script with the following command
(New-Object System.Net.WebClient).DownloadString("https://raw.githubusercontent.com/Markusgp/Untangle/main/untangle.ps1") | powershell
An example of running the app through docker with Java version 15 this is the following commands that will be ran
PowerShell -ExecutionPolicy Bypass
$Env:UNTANGLE_JAVA = '15'
(New-Object System.Net.WebClient).DownloadString("https://raw.githubusercontent.com/Markusgp/Untangle/main/untangle.ps1") | powershell
Once you see the line webpack compiled with 1 warning in your terminal - Untangle is running, and can be utilized by navigating to localhost:8080 in a browser.
Untangle supports local execution. This can be useful as you may want to test Untangle on Java projects which rely on third-party dependencies that are installed on your local machine.
We do however recommend that you perform the analysis on a copy of your Java project, as running Untangle locally will produce source code pollution, in the form of creating the following files in your local Java directory:
- qlpack.yml (codeql dependencies)
- codeql (codeql queries)
- codeql-database-java (the codeql database)
- A buildable maven or gradle Java project.
- Version (16.0+) of npm installed.
- CodeQL CLI installed.
- Your Java project must be buildable on your local machine.
- Git to clone the project
First clone this repository and move the terminal to the root folder of Untangle.
Then execute the run.sh script with parameters:
./run.sh ${language} ${path-to-project}
Where
${language}must be replaced withjava, as it is, for now, the only supported language.${path-to-project}must be replaced with the path to the project that you want to analyze with Untangle - e.g.~/Desktop/MyJavaProject
Once you see the line webpack compiled with 1 warning in your terminal - Untangle is running, and can be utilized by navigating to localhost:3000 in a browser.
If you have already done an analysis on the project, and you wish to see the same data, you do not need to run the whole analysis again.
If you ran the application locally, you can simply use the npm start command from the root folder of the Untangle repo and Untangle with the previous data should become available at localhost:3000.
If you ran the application in docker, you can run docker exec untangled /bin/bash -c "cd react-app; npm start" and Untangle should become available at localhost:8080.
If there is any problems with the tool or you have any questions regarding the tool feel free to reach us on any of these emails