eMedia Installation with VS Code

You can also build your own version with VS Code by following the steps below to build and run the project locally.

1. Clone the repositories

In terminal, copy and paste the following to create a workspace directory and clone all required repositories:

mkdir -p ~/git && cd ~/git
git clone -b main --single-branch https://github.com/entermedia-community/entermedia-core.git
git clone -b main --single-branch https://github.com/entermedia-community/entermedia-server.git
git clone -b main --single-branch https://github.com/entermedia-community/extension-openinstitute.git
git clone -b main --single-branch https://github.com/entermedia-community/app-emshare.git
git clone -b main --single-branch https://github.com/entermedia-community/extension-openedit.git
git clone -b master --single-branch https://github.com/entermedia-community/tomcat9.git
2. Install system dependencies

Install the required dependencies based on your operating system.

Ubuntu (Linux)

sudo apt-get install --no-install-recommends -y \
ffmpeg automake libogg0 libogg-dev libvorbis0a libvorbisenc2 \
x264 lame libimage-exiftool-perl libreoffice unzip git \
libltdl-dev librsvg2-2 libwmf-bin libxt6 libgomp1 \
libtiff5-dev libtiff5 libfaac-dev imagemagick ghostscript

Additional Step: Copy `libx264-normal.ffpreset` into `/home/USERNAME/.ffmpeg/`. Skip this step if the file is already present.

macOS

brew install imagemagick ffmpeg ghostscript

Note: Ensure Homebrew is installed before running the command. Additional dependencies may be required depending on your setup.

3. Open the Project in VS Code

You can open the project using the provided workspace file.

Option 1: From VS Code UI

1. Open VS Code.

2. In the top menu, select:

File → Open Workspace From File

3. In the file picker window, navigate to your home directory.

macOS: /Users/your-username/

Linux: /home/your-username/

4. Open the following folders in order: 

git

entermedia-server

5. Select the file:

entermedia-server.code-workspace

Option 2: From Terminal

code ~/git/entermedia-server/entermedia-server.code-workspace

Optional: Load Default Users

To preload default users, run in terminal:

cd ~/git/extension-openinstitute/serverside/webapp/WEB-INF/data
ln -s ../../../../../entermedia-server/webapp/WEB-INF/data/system

 

Usage

After setting up the application:

1. Start the Server

You can start the application directly from VS Code using one of the following methods:

Option 1: Quick Start

1. Press F5 on your keyboard while VS Code is open.

Option 2: Using the VS Code UI

1. Click the Run and Debug icon in the left sidebar .

2. At the top of the panel, locate the dropdown and select:

Launch Tomcat (tomcat9)

3. Click the green ▶️ Run button to start the server.

What to expect: A terminal window will appear and begin showing logs. Once the server has started successfully, it will be accessible in your browser.

2. Open the Application in Your Browser

1. Once the server is running, open your web browser and navigate to http://localhost:8080/finder/find.

2. When prompted, log in using the default admin credentials:

Username: admin

Password: admin

Note: If the login screen does not appear, ensure the server has fully started and try refreshing the page.

3. Start Using eMediaLibrary

You can now begin working with the platform:

  • Upload and manage your media assets.

  • Use the built-in AI-powered search to quickly find and organize files.

For full documentation, visit https://emedialibrary.com.