Remember on how good our old, beloved Osintgram project became famous by Datalux, and nowadays, it barely even functions? Yeah, ever since the lack of updates and Instagram API changes, the original project on the base repository barely works anymore. What I decided to do is to rewrite the whole entire project, including the IG Private APIs, in my favorite language of all time, Java.
Note that this is still a work in the progress, as the original code is still being analyzed, so that I can convert them into the functional Java code. It is not expected to be fully functional as of now, as I recently started working on Osintgram for Java.
The use of any software, Osintgram / Osintgram4j included, is intended for legitimate and ethical use only. Me, the developer and other contributors of the Osintgram project do not condone or support any form of unethical activities, such as Illegal / Black-Hat Hacking, or having malicious intents in the first place. It is essential to follow all relevant laws and Instagram's ToS (Terms of Service), while using this software.
By using the Osintgram Project, you acknowledge and agree that:
- You are responsible for your actions and usage of this software. This indicates that your actions might, and could be, punishable by the law enforcement (police, FBI etc.). We, as the developers, cannot replace the actions that the law should do, but being vigilante and doing some actions that the law should do, when no actions are taken, could be done.
- Any actions, such as potential misuse, illegal activities or violations of Instagram's policies, are prohibited. By breaking the policies, you acknowledge that your account may or may not be banned, if this tool is being misused.
- We, the developers of this project are not responsible for any consequences or damages that might result from the use of this software. This project is designed for a specific purpose, being information gathering only. Using it for Blackmail or other things, may or may not be held reliable.
Please use the Osintgram project responsibly, respect privacy, maintain ethical standards in all your activities, and use the tool with explicit permission. For legal reasons, always have a legal document that you explicitly gained permission for your actions.
Another point to mention is that the original developer has all the right to tell me, if I am required to archive, delete or completely dump the project. While I am still happy on the development in this project, I am still trying to get in touch with the original developer himself, and hope to get a positive response. The reason is that I do not want to dive myself into a lawsuit due to copyrights. Even though that the Software Licensing exists, I am willing to contact to ensure the legitimacy between me and the developer.
28-03-2024 Update: I am not getting any response from the original developer, which means, I am getting involved with Russian roulette (taking risks), and I'll be trying to not get any Takedown notice, like for example, DMCA Takedown notice, since that will be bad. However, this does not mean that I am not following the Licensing guidelines because if I don't, then I will most likely face legal issues. So, in that case, I will be following the Licensing guidelines. I'll try to get in touch with the developer one last time, and if that won't work, then Licensing guidelines it is.
Now, don't get me wrong. I like this project, and I clearly don't want to close this project whatsoever. But, if I do get forced to close this project down, then you know the cause.
The first reason that I started the development on this project is to have the stability of the Osintgram project back. Since the Instagram APIs have changed, and a single API Call have been removed, the use of the original Project have broken the main method, which the project can no longer start. This is due to a single line, which I debugged, and will work with it, commented out. See the Restoration Process.
Also, even that Python is easy, I decided to switch to a different language. It is none other than Java itself. Yes, I use Java and C++, by the way. However, due to some issues with IntelliJ having multiple modules and working with Gradle / Maven, I decided to reject their offer, and go with the more controllable form, writing a custom Build Process for the project. I hate that issue, and I simply don't want to go that route. I use IntelliJ Ultimate and CLion, by the way.
To fill up the conception about me not using Gradle or Maven, I will be making
an alternative way of building projects that will support multiple languages, making
the time process of building a project faster, especially that you don't have to
run make, Gradle or Maven, or even other processes. That build system might
also be one of the reasons, why I might also ditch the Shell scripts to build this
project, and use the new-style Building. I hear you, you don't like bloat on your
system, but we live in 2024, as of now.
Also, this project might look like it is bloated to the max, but I am still trying to keep it lightweight as possible. Please do note that Java development can receive more and more bloat from time to time, since it can be time-consuming, or the fact that Java is very much verbose and that it forces you into OOP (Object-oriented programming). The bloat should be more than an expectation.
Another point to mention is that I won't provide the building scripts for Windows via the Batch / Powershell files, but I'll still provide the releases for the Windows platform via the "Releases" tab. It is meant to be run on Linux instead of Windows, since I'm an Arch Linux user, by the way.
To set up your workspace for the Osintgram project, you can select this project, or the original project. However, this is Osintgram4j project, which is a part of the OSINT and the Osintgram Family.
This project is mainly targeted for the Linux platform. However, this does not mean that you have to install Linux on your host system. Here are a few workarounds:
- Virtual Machine (VM): Creates a virtual environment that operates like a separate computer, allowing you to run Linux on Windows, macOS, or Android. It's a cost-free and straightforward way to experiment with different operating systems.
- Cloud Shell / Web Server: Offers remote Linux access via
ssh. Costs vary by provider. Linode can be a way, if you follow NetworkChuck. - Windows Subsystem for Linux (WSL): Provides Linux capabilities inside Windows.
Can be enabled through
optionalfeaturesin Windows 10 & 11. - Linux Containers (e.g., Docker): Runs Linux apps in lightweight, isolated containers on your system, allowing to run any Container within the Docker Runtime. Efficient for development and specific app usage. Comes with a Docker setup for easy project initialization.
After having a Linux shell instance, you need to prepare the system for compilation first. You need these following tools:
Debian/Ubuntu based Systems (e.g. Zorin OS)
sudo apt install tar wget cmake build-essentialArch Linux/Manjaro based Systems
sudo pacman -Sy tar wget cmake base-develAfter installing the necessary tools, you can start with building the project. To do so, run these following commands:
git clone https://github.com/BeChris100/osintgram4j && cd osintgram4j
chmod +x setup.sh build.sh
./setup.sh --force-download
./build.shStep-by-step explanation:
- Via the
gitcommand, the project gets downloaded, and by doingcd osintgram4j, the working directory gets changed. - The
chmodcommand will set the Shell files executable. By default,gitwill automatically mark the Shell files executable, but in some cases, it might fail. Running them will make sure that the files are executable. - First Shell script (
setup.sh) will create a working Build Environment. It will create aoutfolder, putting every necessary files, including external libraries (org.jsonis only currently involved) and prepare the necessary files. The--force-downloadcan be removed, as it will rely on the already installed JDK. - Running the
build.shscript will build this project, compiling the C++ code into a shared library, along with the Java Compiler. After the compilation,jpackagegets invoked to create a native executable package without having the need of runningjavaor other pesky scripts. Installation is optional, which will place the native executable into/usr/bin.
However, if you wish to not install directly, the Application Package will be stored
at the current working directory under build/pkg/osintgram4j, with the executable
being under bin/osintgram4j.
The release of Osintgram4j Version v1, or rather pretty soon, v0.1, is introducing a Modding API, which the original project does not have. Now, I wouldn't say that it is a bad thing, but it is a cool feature. The use of client modifications is to enhance the features that the stock Osintgram4j might not have delivered that you might have expected.
While the use of Modifications is still a cool thing, you have to prioritize Privacy, Data Safety and Security. That means, you should only download from sources that I marked as "trusted", or from the original marketplace that does not exist yet. Developers should follow the best practices to prevent the introduction of Malware, Spyware, Ransomware or other software that might be harmful for yo' system.
Documentation on this GitHub Repository will be coming soon. Also, please, don't mind that I'll use ChatGPT in some sections because sometimes, I just need help in writing.
Refer to the Usage file for this project.
