> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livepeer.org/llms.txt
> Use this file to discover all available pages before exploring further.

# pytrickle Changelog

> Release history for pytrickle, a Python package for trickle ingress and egress using the trickle protocol.

export const CustomCardTitle = ({icon, title, variant = "card", iconSize, style = {}, className = "", ...rest}) => {
  const variants = {
    card: {
      display: 'flex',
      alignItems: 'center',
      gap: "var(--lp-spacing-2)",
      marginBottom: "var(--lp-spacing-3)",
      color: 'var(--lp-color-text-primary)',
      fontSize: '1rem',
      fontWeight: 600
    },
    accordion: {
      display: 'inline-flex',
      alignItems: 'center',
      gap: "var(--lp-spacing-2)"
    },
    tab: {
      display: 'inline-flex',
      alignItems: 'center',
      gap: '0.4rem',
      fontSize: '0.875rem'
    }
  };
  const sizes = {
    card: 20,
    accordion: 18,
    tab: 14
  };
  const size = iconSize || sizes[variant] || 20;
  const baseStyle = variants[variant] || variants.card;
  return variant === 'card' ? <div className={className} style={{
    ...baseStyle,
    ...style
  }} {...rest}>
      {typeof icon === 'string' ? <Icon icon={icon} size={size} color="var(--lp-color-accent)" /> : icon}
      {title}
    </div> : <span className={className} style={{
    ...baseStyle,
    ...style
  }} {...rest}>
      {typeof icon === 'string' ? <Icon icon={icon} size={size} color="var(--lp-color-accent)" /> : icon}
      {title}
    </span>;
};

export const Subtitle = ({style = {}, text, children, variant = 'default', fontSize = '', fontWeight = '', fontStyle = '', marginTop = '', marginBottom = '', color = '', className = '', ...rest}) => {
  const renderInlineCode = (value, keyPrefix) => {
    return value.split(/(`[^`]+`)/g).map((segment, index) => {
      if (segment.startsWith('`') && segment.endsWith('`')) {
        return <code key={`${keyPrefix}-code-${index}`}>{segment.slice(1, -1)}</code>;
      }
      return segment;
    });
  };
  const renderInlineMarkup = (value, keyPrefix = 'subtitle') => {
    if (typeof value !== 'string') {
      return value;
    }
    return value.split(/(\*\*[\s\S]+?\*\*)/g).map((segment, index) => {
      if (segment.startsWith('**') && segment.endsWith('**')) {
        const inner = segment.slice(2, -2);
        return <strong key={`${keyPrefix}-strong-${index}`}>
            {renderInlineCode(inner, `${keyPrefix}-strong-${index}`)}
          </strong>;
      }
      return renderInlineCode(segment, `${keyPrefix}-${index}`);
    });
  };
  const renderContent = (value, keyPrefix) => {
    if (Array.isArray(value)) {
      return value.map((item, index) => renderContent(item, `${keyPrefix}-${index}`));
    }
    return renderInlineMarkup(value, keyPrefix);
  };
  const variants = {
    default: {
      fontSize: '1rem',
      fontStyle: 'italic',
      color: 'var(--lp-color-accent)',
      marginBottom: 0
    },
    changelog: {
      fontSize: '0.8rem',
      fontStyle: 'normal',
      fontWeight: 700,
      color: 'var(--lp-color-text-primary)',
      marginBottom: 0
    }
  };
  const base = variants[variant] || variants.default;
  return <span className={className} style={{
    ...base,
    ...fontSize ? {
      fontSize
    } : {},
    ...fontWeight ? {
      fontWeight
    } : {},
    ...fontStyle ? {
      fontStyle
    } : {},
    ...marginTop ? {
      marginTop
    } : {},
    ...marginBottom ? {
      marginBottom
    } : {},
    ...color ? {
      color
    } : {},
    ...style
  }} {...rest}>
      {renderContent(text, 'text')}
      {renderContent(children, 'children')}
    </span>;
};

export const LazyLoad = ({children, height = "200px", offset = "200px", fadeDuration = 400, className = "", style = {}, ...rest}) => {
  const ref = useRef(null);
  const [visible, setVisible] = useState(false);
  const [ready, setReady] = useState(false);
  useEffect(() => {
    const el = ref.current;
    if (!el) return;
    const observer = new IntersectionObserver(([entry]) => {
      if (entry.isIntersecting) {
        setVisible(true);
        observer.disconnect();
      }
    }, {
      rootMargin: offset
    });
    observer.observe(el);
    return () => observer.disconnect();
  }, []);
  useEffect(() => {
    if (!visible) return;
    const frameId = requestAnimationFrame(() => {
      setReady(true);
    });
    return () => cancelAnimationFrame(frameId);
  }, [visible]);
  const placeholder = <div ref={ref} className={className} style={{
    minHeight: height,
    ...style
  }} {...rest} />;
  if (!visible) return placeholder;
  return <div ref={ref} className={className} style={{
    opacity: ready ? 1 : 0,
    transition: `opacity ${fadeDuration}ms ease-in`,
    ...style
  }} {...rest}>
      {children}
    </div>;
};

export const ScrollBox = ({children, maxHeight = 300, showHint = true, ariaLabel = "Scrollable content", style = {}, className = "", ...rest}) => {
  const contentRef = useRef(null);
  const [isOverflowing, setIsOverflowing] = useState(false);
  useEffect(() => {
    const checkOverflow = () => {
      if (contentRef.current) {
        const maxHeightPx = typeof maxHeight === "number" ? maxHeight : parseInt(maxHeight, 10) || 300;
        setIsOverflowing(contentRef.current.scrollHeight > maxHeightPx);
      }
    };
    checkOverflow();
    window.addEventListener("resize", checkOverflow);
    return () => window.removeEventListener("resize", checkOverflow);
  }, [maxHeight, children]);
  return <div className={className} style={{
    position: "relative",
    ...style
  }} {...rest}>
      <div ref={contentRef} role="region" tabIndex={0} aria-label={ariaLabel} style={{
    maxHeight: typeof maxHeight === "number" ? `${maxHeight}px` : maxHeight,
    overflowY: "auto",
    paddingRight: 4
  }} onScroll={e => {
    const el = e.target;
    const atBottom = el.scrollHeight - el.scrollTop <= el.clientHeight + 10;
    const hint = el.parentNode.querySelector("[data-scroll-hint]");
    if (hint) hint.style.opacity = atBottom ? "0" : "1";
  }}>
        {children}
      </div>
      {showHint && isOverflowing && <div data-scroll-hint style={{
    fontSize: 11,
    color: "var(--lp-color-text-muted)",
    textAlign: "center",
    marginTop: 8,
    transition: "opacity 0.2s"
  }}>
          Scroll for more ↓
        </div>}
    </div>;
};

export const DoubleIconLink = ({label = '', labelColor, href = '#', text = '', iconLeft = 'github', iconLeftColor, iconRight = 'arrow-up-right', iconRightColor = 'var(--lp-color-accent)', className = '', style = {}, ...rest}) => {
  return <span className={className} style={{
    whiteSpace: 'nowrap',
    display: 'inline-flex',
    alignItems: 'center',
    gap: "var(--lp-spacing-1)",
    marginLeft: '0.3rem',
    ...style
  }} {...rest}>
      {text && <span style={{
    marginRight: 8
  }}>{text}</span>}
      <Icon icon={iconLeft} color={iconLeftColor} />
      <a href={href} style={{
    color: {
      labelColor
    }
  }}>
        {label}
      </a>
      <div style={{
    marginRight: '0.3rem'
  }}>
        <Icon icon={iconRight} size={12} color={iconRightColor} />
      </div>
    </span>;
};

export const LinkArrow = ({href, label, description, newline = true, borderColor, className = '', style = {}, ...rest}) => {
  const linkArrowStyle = {
    display: 'inline-flex',
    alignItems: 'center',
    justifyContent: 'center',
    gap: "var(--lp-spacing-1)",
    width: 'fit-content',
    ...borderColor && ({
      borderColor
    })
  };
  return <span className={className} style={style} {...rest}>
      {newline && <br />}
      <span style={linkArrowStyle}>
        <a href={href} target="_blank" rel="noopener noreferrer">
          {label}
        </a>
        <Icon icon="arrow-up-right" size={14} color="var(--lp-color-accent)" />
      </span>
      {description && description}
      {description && <div style={{
    height: "var(--lp-spacing-3)"
  }} />}
    </span>;
};

export const InlineDivider = ({margin = "0.75rem 0", padding = "0", color = "var(--lp-color-border-default)", opacity = 0.4, height = "1px", className = "", style = {}, ...rest}) => <hr role="separator" className={className} style={{
  border: "none",
  margin,
  padding,
  height,
  backgroundColor: color,
  opacity,
  ...style
}} {...rest} />;

export const CustomDivider = ({color = "var(--lp-color-border-default)", middleText = "", spacing = "default", style = {}, className = "", ...rest}) => {
  const spacingPresets = {
    default: {
      margin: "24px 0"
    },
    overlap: {
      margin: "-1rem 0 -1rem 0"
    },
    tight: {
      margin: "0 0 -1rem 0"
    },
    section: {
      margin: "0 0 -2rem 0"
    },
    sectionOverlap: {
      margin: "-1rem 0 -2rem 0"
    },
    deepOverlap: {
      margin: "-1rem 0 -1.5rem 0"
    }
  };
  const spacingStyle = spacingPresets[spacing] || spacingPresets.default;
  return <div role="separator" aria-orientation="horizontal" className={className} style={{
    display: "flex",
    alignItems: "center",
    ...spacingStyle,
    fontSize: style?.fontSize || "16px",
    height: "fit-content",
    ...style
  }} {...rest}>
      <span style={{
    marginRight: "var(--lp-spacing-px-8)",
    opacity: 0.2
  }}>
        <Icon icon="/snippets/assets/logos/Livepeer-Logo-Symbol-Theme.svg" />
      </span>
      <div style={{
    flex: 1,
    height: "1px",
    background: "var(--lp-color-border-default)",
    opacity: 0.4
  }}></div>
      {middleText && <>
          <Icon icon="circle" size={2} />
          <span style={{
    margin: "0 8px",
    fontWeight: "bold",
    color: color,
    opacity: 0.7
  }}>
            {middleText}
          </span>
          <Icon icon="circle" size={2} />
        </>}
      <div style={{
    flex: 1,
    height: "1px",
    background: "var(--lp-color-border-default)",
    opacity: 0.4
  }}></div>
      <span style={{
    marginLeft: "var(--lp-spacing-px-8)",
    opacity: 0.2
  }}>
        <span style={{
    display: "inline-block",
    transform: "scaleX(-1)"
  }}>
          <Icon icon="/snippets/assets/logos/Livepeer-Logo-Symbol-Theme.svg" />
        </span>
      </span>
    </div>;
};

<Tip>
  This page is an automated workflow.
  <Subtitle variant="changelog" style={{fontSize: "0.95rem", marginTop: "0.25rem"}}>Subscribe to this changelog's <LinkArrow label="RSS Feed" href="/v2/resources/changelog/pytrickle/rss.xml" newline={false} /></Subtitle>
</Tip>

<CustomDivider style={{margin: "-0.5rem 0 -1.5rem 0"}} />

Track releases for <LinkArrow label="pytrickle" href="https://github.com/livepeer/pytrickle/releases" newline={false} /> on GitHub.

<CustomDivider />

<LazyLoad height="600px">
  <Update label="v0.1.9" tags={["Features", "Fixes"]} rss={{ title: "pytrickle v0.1.9", description: "* fix(requirements): downgrade av package version to <=14.2.0 by @eliteprox in https://github.com/livepeer/pytrickle/..." }} description={<Subtitle variant="changelog">February 2026</Subtitle>}>
    ## v0.1.9

    <CustomCardTitle variant="tab" icon="user-robot" title="_AI Summary_" />

    ## What's Changed

    * fix(requirements): downgrade av package version to \<=14.2.0
    * Feat/send custom monitoring event

    <InlineDivider margin="1rem 0" />

    <DoubleIconLink label="View release on GitHub" href="https://github.com/livepeer/pytrickle/releases/tag/v0.1.9" iconLeft="github" />
  </Update>

  <Update label="v0.1.8" tags={["Fixes"]} rss={{ title: "pytrickle v0.1.8", description: "* fix for holding frames in output queue if no publisher by @ad-astra-video in https://github.com/livepeer/pytrickle/..." }} description={<Subtitle variant="changelog">December 2025</Subtitle>}>
    ## v0.1.8

    <CustomCardTitle variant="tab" icon="user-robot" title="_AI Summary_" />

    ## What's Changed

    * fix for holding frames in output queue if no publisher

    <InlineDivider margin="1rem 0" />

    <DoubleIconLink label="View release on GitHub" href="https://github.com/livepeer/pytrickle/releases/tag/v0.1.8" iconLeft="github" />
  </Update>

  <Update label="v0.1.7" tags={["Fixes"]} rss={{ title: "pytrickle v0.1.7", description: "* fix checking state and return current state with responses by @ad-astra-video in https://github.com/livepeer/pytric..." }} description={<Subtitle variant="changelog">December 2025</Subtitle>}>
    ## v0.1.7

    <CustomCardTitle variant="tab" icon="user-robot" title="_AI Summary_" />

    ## What's Changed

    * fix checking state and return current state with responses

    <InlineDivider margin="1rem 0" />

    <DoubleIconLink label="View release on GitHub" href="https://github.com/livepeer/pytrickle/releases/tag/v0.1.7" iconLeft="github" />
  </Update>

  <Update label="v0.1.6" tags={["Features", "Performance"]} rss={{ title: "pytrickle v0.1.6", description: "* feat: Implement resolution detection feature from video tensor by @JJassonn69 in https://github.com/livepeer/pytric..." }} description={<Subtitle variant="changelog">December 2025</Subtitle>}>
    ## v0.1.6

    <CustomCardTitle variant="tab" icon="user-robot" title="_AI Summary_" />

    ## What's Changed

    * feat: Implement resolution detection feature from video tensor
    * feat(protocol, decoder, client): enable max\_framerate parameter updates
    * feat(client, overlay): Optimise frame processing during manual loading states

    <InlineDivider margin="1rem 0" />

    <DoubleIconLink label="View release on GitHub" href="https://github.com/livepeer/pytrickle/releases/tag/v0.1.6" iconLeft="github" />
  </Update>

  <Update label="v0.1.5" tags={["Features", "Fixes"]} rss={{ title: "pytrickle v0.1.5", description: "* Feat/add deepwiki badge by @JJassonn69 in https://github.com/livepeer/pytrickle/pull/43" }} description={<Subtitle variant="changelog">November 2025</Subtitle>}>
    ## v0.1.5

    <CustomCardTitle variant="tab" icon="user-robot" title="_AI Summary_" />

    ## What's Changed

    * Feat/add deepwiki badge
    * fix generative stream HxW
    * feat(frame\_processor): add optional `on_stream_start` method callback
    * server(api): change default server path
    * feat: Decorator System Enhancement
    * feat: Add new examples and update project structure
    * chore(examples): Move examples back to root, fix cli import of examples
    * fix failing tests
    * refactor(error\_callback): fix linter error in init "Module level import not at top of file"
    * feat: Pytrickle cli template
    * feat(client, server): Add frame overlay, call model\_loader on server startup
    * fix(server): Improve error handling during stream start failures
    * fix: ensure segments cut if packets received on one stream
    * fix: end stream if trickle stream not found
    * feat(client): Add initial stream parameters to `on_stream_start`
    * feat(overlay): Add frame count threshold for auto-disable functionality

    <InlineDivider margin="1rem 0" />

    <DoubleIconLink label="View release on GitHub" href="https://github.com/livepeer/pytrickle/releases/tag/v0.1.5" iconLeft="github" />
  </Update>

  <Update label="v0.1.4" tags={["Release"]} rss={{ title: "pytrickle v0.1.4", description: "* update to use input frame queue for generative streams by @ad-astra-video in https://github.com/livepeer/pytrickle/..." }} description={<Subtitle variant="changelog">September 2025</Subtitle>}>
    ## v0.1.4

    <CustomCardTitle variant="tab" icon="user-robot" title="_AI Summary_" />

    ## What's Changed

    * update to use input frame queue for generative streams
    * replace pynvml with nvidia-ml-py in requirements.txt

    <InlineDivider margin="1rem 0" />

    <DoubleIconLink label="View release on GitHub" href="https://github.com/livepeer/pytrickle/releases/tag/v0.1.4" iconLeft="github" />
  </Update>

  <Update label="v0.1.3" tags={["Features"]} rss={{ title: "pytrickle v0.1.3", description: "* feat: add frame skipping by @eliteprox in https://github.com/livepeer/pytrickle/pull/20" }} description={<Subtitle variant="changelog">September 2025</Subtitle>}>
    ## v0.1.3

    <CustomCardTitle variant="tab" icon="user-robot" title="_AI Summary_" />

    ## What's Changed

    * feat: add frame skipping
    * Feat/optional publish subscribe
    * gracefully handle connection failed errors during capability registration

    <InlineDivider margin="1rem 0" />

    <DoubleIconLink label="View release on GitHub" href="https://github.com/livepeer/pytrickle/releases/tag/v0.1.3" iconLeft="github" />
  </Update>

  <Update label="v0.1.2" tags={["Features", "Fixes"]} rss={{ title: "pytrickle v0.1.2", description: "* feat: add stream processor by @ad-astra-video in https://github.com/livepeer/pytrickle/pull/11" }} description={<Subtitle variant="changelog">September 2025</Subtitle>}>
    ## v0.1.2

    <CustomCardTitle variant="tab" icon="user-robot" title="_AI Summary_" />

    ## What's Changed

    * feat: add stream processor
    * server: fix client/protocol init, customise server config, consolidate health manager
    * Feat/add data publishing to stream processor
    * fix: protocol publisher fails to report error
    * add async for param\_updater and model\_loader
    * encoder: set default image tensor format to match decoder (RGB)
    * fix (stream\_processor): Remove self.\_ready to fix stuck passthrough
    * Fix append method for data\_queue in client.py
    * use semantic versioning for pkg and /version, add /app-version

    ## New Contributors

    * @ad-astra-video made their first contribution in [https://github.com/livepeer/pytrickle/pull/11](https://github.com/livepeer/pytrickle/pull/11)

    <InlineDivider margin="1rem 0" />

    <DoubleIconLink label="View release on GitHub" href="https://github.com/livepeer/pytrickle/releases/tag/v0.1.2" iconLeft="github" />
  </Update>

  <Update label="v0.1.1" tags={["Features"]} rss={{ title: "pytrickle v0.1.1", description: "* feat: BYOC StreamServer, FrameProcessor with example app by @eliteprox in https://github.com/livepeer/pytrickle/pull/8" }} description={<Subtitle variant="changelog">August 2025</Subtitle>}>
    ## v0.1.1

    <CustomCardTitle variant="tab" icon="user-robot" title="_AI Summary_" />

    ## What's Changed

    * feat: BYOC StreamServer, FrameProcessor with example app

    <InlineDivider margin="1rem 0" />

    <DoubleIconLink label="View release on GitHub" href="https://github.com/livepeer/pytrickle/releases/tag/v0.1.1" iconLeft="github" />
  </Update>

  <Update label="v0.0.1" tags={["Features"]} rss={{ title: "pytrickle v0.0.1", description: "* add error_callback for TrickleClient to handle errors by @eliteprox in https://github.com/livepeer/pytrickle/pull/3" }} description={<Subtitle variant="changelog">August 2025</Subtitle>}>
    ## v0.0.1

    <CustomCardTitle variant="tab" icon="user-robot" title="_AI Summary_" />

    ## What's Changed

    * add error\_callback for TrickleClient to handle errors
    * add text publisher channel
    * refactor: trickle session error handling and cleanup
    * feat: pass audio frames to frame processor

    ## New Contributors

    * @eliteprox made their first contribution in [https://github.com/livepeer/pytrickle/pull/3](https://github.com/livepeer/pytrickle/pull/3)

    <InlineDivider margin="1rem 0" />

    <DoubleIconLink label="View release on GitHub" href="https://github.com/livepeer/pytrickle/releases/tag/v0.0.1" iconLeft="github" />
  </Update>
</LazyLoad>
