Skip to content

Quick Start

Overview

eMediaLibrary is an open-source digital asset management platform designed to centralize, organize, and make media accessible at scale.

It provides a unified and secure interface for managing distributed media across multiple storage systems, reducing fragmentation and improving discoverability. Built with flexibility and extensibility in mind, the platform enables teams to create custom workflows while maintaining full control over their data.

eMediaLibrary is fully open source, independently maintained, and operates without reliance on proprietary third-party platforms.

Learn more: https://emedialibrary.com


Features

  • Centralized Media Management
    Aggregate and manage media assets from multiple sources in a single interface.

  • AI-Powered Search
    Automatically index and retrieve media using intelligent search capabilities.

  • Multi-Storage Integration
    Connect and unify local storage, cloud services, and external repositories.

  • Web-Based Interface
    Access and manage assets through a modern browser-based application.

  • Extensible Architecture
    Customize workflows, integrations, and features to fit your needs.

  • Secure by Design
    Built with a strong focus on data privacy, control, and system integrity.


Table of Contents


Installation

You can deploy eMediaLibrary using Docker for a fast and reliable setup, or build it locally for development and customization.

Docker Deployment


Build from Source

Follow these steps to build and run the project locally.

1. Clone the Repositories

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

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

Option 2: Using the VS Code UI

  • Click the Run and Debug icon in the left sidebar .
  • At the top of the panel, locate the dropdown and select:
    • Launch Tomcat (tomcat9)
  • 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


Contributing

Contributions are welcome and appreciated.

Note: A signed Contributor License Agreement (CLA) is required before contributions can be accepted.


License

This project is licensed under the LGPL (Lesser General Public License).


Acknowledgements

This project is sponsored by eMediaLibrary.com.

Pinned Loading

  1. app-emshare app-emshare Public

    HTML 3 2

  2. entermedia-server entermedia-server Public

    EnterMedia Server

    JavaScript 13 20

  3. entermedia-core entermedia-core Public

    Java 7 5

  4. desktop-mediaboat desktop-mediaboat Public

    JavaScript 2

Repositories

Showing 10 of 104 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…