Release 0.4.0

.gitignore

@@ -16,3 +16,5 @@ venv/
 .vscode/*
 example.ipynb
 example.py
+# test_local.py
+capture_bin/videodb_capture_bin/bin/*

capture_bin/build/lib.macosx-15.5-arm64-cpython-312/videodb_capture_bin/__init__.py

@@ -0,0 +1,24 @@
+import os
+import sys
+
+def get_binary_path():
+    """Returns the absolute path to the recorder binary."""
+    # This file is at: capture_bin/videodb_capture_bin/__init__.py
+    # Binary is at:  capture_bin/videodb_capture_bin/bin/recorder (or .exe)
+    base_dir = os.path.dirname(os.path.abspath(__file__))
+    bin_dir = os.path.join(base_dir, "bin")
+
+    if sys.platform == "win32":
+        binary_name = "recorder.exe"
+    else:
+        binary_name = "recorder"
+
+    binary_path = os.path.join(bin_dir, binary_name)
+
+    if not os.path.exists(binary_path):
+        raise FileNotFoundError(
+            f"Recorder binary not found at {binary_path}. "
+            "Please ensure the package was installed correctly for your platform."
+        )
+
+    return binary_path

capture_bin/setup.py

@@ -0,0 +1,27 @@
+from setuptools import setup, Distribution
+
+class BinaryDistribution(Distribution):
+    """Forces the distribution to be platform-specific."""
+    def has_ext_modules(foo):
+        return True
+
+VERSION = "0.2.4"
+
+setup(
+    name="videodb-capture-bin",
+    version=VERSION,
+    author="VideoDB",
+    description="Binary container for VideoDB Capture runtime",
+    packages=["videodb_capture_bin"],
+    package_data={
+        "videodb_capture_bin": ["bin/*"],
+    },
+    include_package_data=True,
+    distclass=BinaryDistribution,
+    classifiers=[
+        "Intended Audience :: Developers",
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: Apache Software License",
+    ],
+    python_requires=">=3.8",
+)

capture_bin/videodb_capture_bin.egg-info/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: videodb-capture-bin
+Version: 0.2.4
+Summary: Binary container for VideoDB Capture runtime
+Author: VideoDB
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: Apache Software License
+Requires-Python: >=3.8
+Dynamic: author
+Dynamic: classifier
+Dynamic: requires-python
+Dynamic: summary

capture_bin/videodb_capture_bin.egg-info/SOURCES.txt

@@ -0,0 +1,6 @@
+setup.py
+videodb_capture_bin/__init__.py
+videodb_capture_bin.egg-info/PKG-INFO
+videodb_capture_bin.egg-info/SOURCES.txt
+videodb_capture_bin.egg-info/dependency_links.txt
+videodb_capture_bin.egg-info/top_level.txt

capture_bin/videodb_capture_bin.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

capture_bin/videodb_capture_bin.egg-info/top_level.txt

@@ -0,0 +1 @@
+videodb_capture_bin

capture_bin/videodb_capture_bin/__init__.py

@@ -0,0 +1,24 @@
+import os
+import sys
+
+def get_binary_path():
+    """Returns the absolute path to the recorder binary."""
+    # This file is at: capture_bin/videodb_capture_bin/__init__.py
+    # Binary is at:  capture_bin/videodb_capture_bin/bin/recorder (or .exe)
+    base_dir = os.path.dirname(os.path.abspath(__file__))
+    bin_dir = os.path.join(base_dir, "bin")
+
+    if sys.platform == "win32":
+        binary_name = "recorder.exe"
+    else:
+        binary_name = "recorder"
+
+    binary_path = os.path.join(bin_dir, binary_name)
+
+    if not os.path.exists(binary_path):
+        raise FileNotFoundError(
+            f"Recorder binary not found at {binary_path}. "
+            "Please ensure the package was installed correctly for your platform."
+        )
+
+    return binary_path

requirements.txt

@@ -1,3 +1,4 @@
 requests==2.31.0
 backoff==2.2.1
 tqdm==4.66.1
+websockets>=12.0

setup.py

@@ -28,13 +28,16 @@
     long_description=long_description,
     long_description_content_type="text/markdown",
     url=about["__url__"],
-    packages=find_packages(exclude=["tests", "tests.*"]),
+    packages=find_packages(exclude=["tests", "tests.*", "capture_bin", "videodb_capture_bin"]),
     python_requires=">=3.8",
     install_requires=[
         "requests>=2.25.1",
         "backoff>=2.2.1",
         "tqdm>=4.66.1",
     ],
+    extras_require={
+        "capture": ["videodb-capture-bin>=0.2.4"],
+    },
     classifiers=[
         "Intended Audience :: Developers",
         "Programming Language :: Python :: 3",

videodb/__about__.py

@@ -2,7 +2,7 @@
 
 
 
-__version__ = "0.3.0"
+__version__ = "0.4.0"
 __title__ = "videodb"
 __author__ = "videodb"
 __email__ = "contact@videodb.io"

videodb/__init__.py

@@ -20,8 +20,24 @@
     ResizeMode,
     VideoConfig,
     AudioConfig,
+    ReframeMode,
+    SegmentationType,
 )
 from videodb.client import Connection
+from videodb.capture_session import CaptureSession
+from videodb.websocket_client import WebSocketConnection
+from videodb.capture import CaptureClient, Channel, AudioChannel, VideoChannel, Channels
+
+__all__ = [
+    "connect",
+    "CaptureSession",
+    "WebSocketConnection",
+    "CaptureClient",
+    "Channel",
+    "AudioChannel",
+    "VideoChannel",
+    "Channels",
+]
 from videodb.exceptions import (
     VideodbError,
     AuthenticationError,
@@ -51,6 +67,8 @@
     "ResizeMode",
     "VideoConfig",
     "AudioConfig",
+    "ReframeMode",
+    "SegmentationType",
 ]
 
 

videodb/_constants.py

@@ -12,6 +12,12 @@ class MediaType:
     image = "image"
 
 
+class RTStreamChannelType:
+    mic = "mic"
+    screen = "screen"
+    system_audio = "system_audio"
+
+
 class SearchType:
     semantic = "semantic"
     keyword = "keyword"
@@ -27,6 +33,7 @@ class IndexType:
 class SceneExtractionType:
     shot_based = "shot"
     time_based = "time"
+    transcript = "transcript"
 
 
 class Workflows:
@@ -49,6 +56,11 @@ class Segmenter:
     sentence = "sentence"
 
 
+class SegmentationType:
+    sentence = "sentence"
+    llm = "llm"
+
+
 class ApiPath:
     collection = "collection"
     upload = "upload"
@@ -91,6 +103,11 @@ class ApiPath:
     record = "record"
     editor = "editor"
     reframe = "reframe"
+    clip = "clip"
+    capture = "capture"
+    session = "session"
+    token = "token"
+    websocket = "websocket"
 
 
 class Status:
@@ -101,6 +118,7 @@ class Status:
 class MeetingStatus:
     initializing = "initializing"
     processing = "processing"
+    joined = "joined"
     done = "done"
 
 

videodb/_upload.py

@@ -29,6 +29,7 @@ def upload(
     callback_url: Optional[str] = None,
     file_path: Optional[str] = None,
     url: Optional[str] = None,
+    collection_id: Optional[str] = None,
 ) -> dict:
     """Upload a file or URL.
 
@@ -40,9 +41,12 @@ def upload(
     :param str callback_url: URL to receive the callback (optional)
     :param str file_path: Path to the file to be uploaded
     :param str url: URL of the file to be uploaded
+    :param str collection_id: ID of the collection to upload to (optional)
     :return: Dictionary containing upload response data
     :rtype: dict
     """
+    collection_id = collection_id or _connection.collection_id
+
     if source and (file_path or url):
         raise VideodbError("source cannot be used with file_path or url")
 
@@ -68,7 +72,7 @@ def upload(
         try:
             name = file_path.split("/")[-1].split(".")[0] if not name else name
             upload_url_data = _connection.get(
-                path=f"{ApiPath.collection}/{_connection.collection_id}/{ApiPath.upload_url}",
+                path=f"{ApiPath.collection}/{collection_id}/{ApiPath.upload_url}",
                 params={"name": name},
             )
             upload_url = upload_url_data.get("upload_url")
@@ -85,7 +89,7 @@ def upload(
             raise VideodbError("Error while uploading file", cause=e)
 
     upload_data = _connection.post(
-        path=f"{ApiPath.collection}/{_connection.collection_id}/{ApiPath.upload}",
+        path=f"{ApiPath.collection}/{collection_id}/{ApiPath.upload}",
         data={
             "url": url,
             "name": name,