From c5ba639a081200d2a96aec1552ab47072bf5693a Mon Sep 17 00:00:00 2001
From: Esa Kataja <ekataja@gmail.com>
Date: Thu, 14 Nov 2024 23:57:23 +0200
Subject: [PATCH] Add First iteration of readme.md

---
 README.md | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/README.md b/README.md
index e69de29..c311401 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,38 @@
+# VidEnc
+
+This is a command-line application that analyzes video files using `ffprobe` to extract stream information (video, audio, subtitles). It then uses the OMDb API to fetch additional movie details such as title and release date, given an IMDB ID.
+
+## Workflow
+
+1. **Input:** The application takes a video file path as input, along with an optional IMDB ID and a flag to disable subtitle processing.
+
+2. **FFprobe Analysis:** It runs `ffprobe` on the input video file to extract stream information in JSON format.
+
+3. **Stream Parsing:** The JSON output is parsed to identify video, audio, and subtitle streams.
+
+4. **OMDb API Lookup (Optional):** If an IMDB ID is provided, the application queries the OMDb API to retrieve movie title and release date.
+
+5. **Output:** Finally, it prints a command string based on the extracted information.  This command string is likely intended for further video processing or encoding.
+
+## Usage
+
+```bash
+python src/app.py <video_file> [-i <imdb_id>] [-ns]
+```
+
+* `<video_file>`: Path to the video file.
+* `-i <imdb_id>`: (Optional) IMDB ID of the movie.
+* `-ns`: (Optional) Flag to disable subtitle processing.
+
+
+## Example
+
+```bash
+python src/app.py my_movie.mp4 -i tt1234567
+```
+
+This would analyze `my_movie.mp4`, fetch details from OMDb using IMDB ID `tt1234567`, and print a command string.
+
+## Unit Tests
+
+There are no unit tests included in this project.