{"library":"mediapy","title":"mediapy","description":"mediapy is a Python library designed to simplify reading, writing, and displaying images and videos, especially within IPython/Jupyter notebooks. Developed by Google LLC, it is currently on version 1.2.6 and receives updates periodically.","language":"python","status":"active","last_verified":"Fri May 15","install":{"commands":["pip install mediapy"],"cli":null},"imports":["import mediapy as media"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import mediapy as media\nimport numpy as np\nimport shutil\nimport os\n\n# --- Image Example ---\nimage_url = 'https://github.com/hhoppe/data/raw/main/image.png'\nprint(f\"Reading image from: {image_url}\")\nimage = media.read_image(image_url)\nprint(f\"Image shape: {image.shape}, dtype: {image.dtype}\")\nmedia.show_image(image, title='Remote Image')\n\n# Example of creating and saving an image\ncheckerboard = np.kron([[0, 1] * 16, [1, 0] * 16] * 16, np.ones((4, 4)))\noutput_image_path = '/tmp/checkerboard.png'\nmedia.write_image(output_image_path, checkerboard)\nprint(f\"\\nCheckerboard image written to {output_image_path}\")\n\n# --- Video Example (requires ffmpeg) ---\nif shutil.which('ffmpeg'):\n    video_url = 'https://github.com/hhoppe/data/raw/main/video.mp4'\n    print(f\"\\nReading video from: {video_url}\")\n    video = media.read_video(video_url)\n    print(f\"Video shape: {video.shape}, dtype: {video.dtype}\")\n    if hasattr(video, 'metadata') and hasattr(video.metadata, 'fps'):\n        print(f\"Video framerate: {video.metadata.fps} fps\")\n        media.show_video(video, title='Remote Video', fps=video.metadata.fps)\n    else:\n        media.show_video(video, title='Remote Video - FPS unknown')\nelse:\n    print(\"\\nFFmpeg is not installed or not in PATH. Skipping video example.\")\n    print(\"Please install ffmpeg (e.g., 'brew install ffmpeg' on macOS, 'apt install ffmpeg' on Debian/Ubuntu) for video functionality.\")\n","lang":"python","description":"This quickstart demonstrates how to read and display both local/remote images and videos. For video functionality, ensure that the `ffmpeg` command-line tool is installed and accessible in your system's PATH. An example of writing an image to a file is also included.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-15","installed_version":"1.2.6","pypi_latest":"1.2.6","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":10.5,"avg_import_s":3.86,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"mediapy","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":3.49,"mem_mb":51.7,"disk_size":"233.6M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"mediapy","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":10.5,"import_time_s":2.63,"mem_mb":51.7,"disk_size":"226M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"mediapy","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":4.78,"mem_mb":57.9,"disk_size":"251.6M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"mediapy","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":10.4,"import_time_s":4.37,"mem_mb":57.9,"disk_size":"242M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"mediapy","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":4.32,"mem_mb":56.5,"disk_size":"237.4M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"mediapy","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":10,"import_time_s":4.41,"mem_mb":56.5,"disk_size":"228M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"mediapy","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":3.93,"mem_mb":57.1,"disk_size":"236.8M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"mediapy","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":10.1,"import_time_s":4.18,"mem_mb":57.1,"disk_size":"227M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"mediapy","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"noisy","install_time_s":null,"import_time_s":3.45,"mem_mb":51.4,"disk_size":"214.2M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"mediapy","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"noisy","install_time_s":11.6,"import_time_s":3.01,"mem_mb":51.4,"disk_size":"209M"}]}}