This release focuses on improving compatibility with data in the real world and bug fixes. It also includes a new Set API for working with file paths via drag-and-drop interfaces across Linux, macOS, and Windows.

This release also marks the start of exclusively publishing changelogs via GitHub Releases. The old CHANGELOG.md has been removed due to maintenance overhead and duplication. v3.6.0 is the last revision to include this file.

Added

• Add support for pasting lists of files via Set::file_list interface by @Gae24 in #181
• Support windows-sys 0.60 in arboard's allowed version range by @complexspaces in #201

Changed

• Fix grammar and typos by @complexspaces and @gagath in #194 and #196
• Prefer PNG when pasting images on Windows by @wcassels in #198
  • Note: This change greatly increases compatibility for "complicated" images that contain alpha values and/or transparent pixels. Support for transparency in BITMAP formats is ill-defined and inconsistently implemented in the wild, but is consistent in PNG. Most applications loading images onto the clipboard include PNG-encoded data already.
• Bitmap images pasted on Windows now use the image crate instead of a homegrown internal parser.
  • This should not regress any existing Bitmap use cases and instead will provide more consistent and robust parsing. If you notice something now broken, please open an issue!

Fixed

• Remove silent dropping of file paths when non-UTF8 was mixed in on Linux by @Gae24 in #197
• Fix parsing of 24-bit bitmaps on Windows by @wcassels in #198
  • Example: Images with transparency copied by Firefox are now handled correctly, among others.

New Contributors

• @gagath made their first contribution in #196
• @wcassels made their first contribution in #198

Full Changelog: v3.6.0...v3.6.1

Added

• Add support for excluding data from clipboard history on Linux.
• arboard, in debug builds, now attempts to call out clipboard lifetime mishandling.
  • This is a debugging feature, and as such has no absolute or promised behavior.

Changed

• The background thread in the X11 backend no longer exits on every selection request failure.

Fixed

• Handled cases where using an unsupported Primary clipboard on Wayland would return the wrong error.
• Clearing the clipboard on Linux now behaves correctly when interacting with other apps on the system.
• Pasting text with an explicit locale ID on Windows now works as intended.

New Contributors

• @MrSmoer made their first contribution in #155
• @crumblingstatue made their first contribution in #186

Full Changelog: v3.5.0...v3.6.0

Added

• Add file_list to the Get interface.
• Implement Get::html() for all platforms.

Changed

• Updated wl-clipboard-rs to 0.9.
• Improved windows-sys version compatibility range to support 0.52 - 0.60.
• Updated objc2 to v0.6.
• Raised MSRV to 1.71.0.

New Contributors

• @hamirmahal made their first contribution in #169
• @Gae24 made their first contribution in #163

Full Changelog: v3.4.1...v3.5.0

Added

• Added support for excluding macOS clipboard items from history.
  • Note that macOS has no official history, so arboard's implementation uses a community standard instead.

New Contributors

• @Hinton made their first contribution in #159

Full Changelog: v3.4.0...v3.4.1

Added

• Added a wait_until method for Linux, as a superset of the existing wait functionality.
  This is a helper for letting an application wait without manual timeout handling.

Fixed

• Transparency in copied images now behaves better in certain Windows apps.

Changed

• Updated image to 0.25.
• Removed direct thiserror dependency.
• Fixed Linux documentation links
• Raised MSRV to 1.67.1
• Reverted timeout behavior of Clipboard::new() on platforms using X11. Applications are
  encouraged to wrap constructor calls in their own thread/channel timeout mechanisms instead
  to make sure the behavior matches each usecase.
• Migrated away from objc to the objc2 ecosystem for the Apple clipboard implementation.

Full Changelog: v3.3.2...v3.4.0

Fixed

• Fixed compilation on Windows when using the image-data feature combined with older Rust compilers.

Changed

• Updated Windows clipboard and migrated from winapi to windows-sys.
• Internally migrated to Rust 2021 edition.
• Significantly improved the crate's error documentation.
• Updated core-graphics to 0.23
• Updated x11rb to 0.13

Full Changelog: v3.3.0...v3.3.1

Added

• Add support for ExcludeClipboardContentFromMonitorProcessing on Windows platforms.

Changed

• Improved timeout error messaging.
• Update wl-clipboard-rs to 0.8.
• Update x11rb to 0.12.

Fixed

• Removed all leaks from the macOS clipboard code. Previously, both the get and set methods leaked data.
• Fixed documentation examples so that they compile on Linux.
• Removed extra whitespace macOS's HTML copying template. This caused unexpected behavior in some apps.

Changed

• Added a timeout when connecting to the X11 server on UNIX platforms. In situations where the X11 socket is present but unusable, the clipboard initialization will no longer hang indefinitely.
• Removed macOS-specific dependency on the once_cell crate.

Changed

• The Windows clipboard now behaves consistently with the other
  platform implementations again.
• Significantly improve cross-platform documentation of Clipboard.
• Remove lingering uses of the dbg! macro in the Wayland backend.