1.1.7 April 5 2024

Bump .so version to 6. This was missed in the previous release.

1.1.6 April 4 2024

Updated vendored version of minizip to v 1.3.0 to include upstream fixes.

Feature request #419.
Added quote_prefix format property.

Feature request #385.
Added support for signed VBA projects.

Fix worksheet password hashing algorithm for long passwords. Replace/fix the worksheet protection password algorithm so that is works correctly for strings over 24 chars.

Fix cmake minizip version check.

Feature request #405.
Fix for buffer overflow with utf-8 strings in data validation.

Feature request #394.
Fix for range in text type conditional format.

Feature request #395.
Fix 32bit multiply with overflow issue for images.

Fix multiply with overflow issue when image locations in the worksheet were greater than the u32 max value.
Added Swift package manager support.

Added support for building Zig library.

1.1.5 December 30 2022

Added support for writing a workbook to a memory buffer instead of to a file via the output_buffer parameter of workbook_new_opt(). See also output_buffer.c.
Add support for using in-memory data instead of temporary files on systems where fmemopen() and open_memstream() are supported. This requires the USE_MEM_FILE compilation option.

1.1.4 October 9 2021

Added support for Worksheet tables. Tables in Excel are a way of grouping a range of cells into a single entity that has common formatting or that can be referenced from formulas. Tables can have column headers, autofilters, total rows, column formulas and default formatting. See Working with Worksheet Tables and tables.c.
Added support for adding a macro button to a worksheet. See macro.c.

1.1.3 August 9 2021

Changed worksheet_filter_column2() parameter name "operator" to "and_or" to avoid a conflict with the C++ reserved keyword.

1.1.2 August 8 2021

Added support for autofilter rules. See Working with Autofilters and autofilter.c.

Feature request #254.
Added Description/Alt Text and Decorative accessibility options for charts. These options were already available for images.

1.1.1 July 12 2021

Added optional third party library to handle sprintf handling of doubles. This is to avoid issues with number formatting in some locales. The optional library is the Milo Yip DTOA implementation. See Using a double formatting library.

Issue #272.
Added the LXW_EXPLICIT_FALSE variable to allow the default bold property in chart title fonts to be turned off.

Issue #199.

1.1.0 July 9 2021

Fix for Cocoapod issue where local md5 files conflicted with BoringSSL headers.

Issue #342.

1.0.9 July 7 2021

Added support for Excel 365 dynamic arrays. See worksheet_write_dynamic_array_formula() worksheet_write_dynamic_formula() and Dynamic Array support.

1.0.8 July 3 2021

Fix for dynamic library soname on Linux.

1.0.7 July 1 2021

Added support for writing Unix date/times via the worksheet_write_unixtime() function.
Added support for dynamic library soname version to help packagers and build systems differentiate ABI versions.

1.0.6 May 28 2021

Added support for using OpenSSL MD5 functions instead of built in third party library. See MD5 functionality for handling duplicate images.

1.0.5 May 13 2021

Added support for worksheet background images via worksheet_set_background().

1.0.4 May 8 2021

Added support for GIF image files (and in Excel 365, animated GIF files).

1.0.3 April 20 2021

Added some fixes to make the library compile more cleanly as an R library.

1.0.2 April 15 2021

Added option to set row heights and column widths in pixels via the worksheet_set_row_pixels() and worksheet_set_column_pixels() functions.

1.0.1 March 30 2021

Added support for pkg-config to Make/Cmake installs. See the Using the library section of the Getting Started guide.

Added ability to add accessibility options "description" and "decorative" to images via worksheet_insert_image_opt() and lxw_image_options.

Added the workbook_read_only_recommended() function to set the Excel "Read-only Recommended" option that is available when saving a file.

Fixed issue where pattern formats without colors were given a default black fill color.

Added option to set a chart crossing to 'min' via chart_axis_set_crossing_min() as well as the existing 'max' option. The 'min' option isn't available in the Excel interface but can be enabled via VBA.

Added some additional information on using constant_memory mode with memory mounted /tmp directories. See Constant memory mode and the /tmp directory.

Issue #306.
Added build option to compile libxlsxwriter as a "universal binary" for both Apple silicon and Intel-based Macs, i.e., arm64 and x86_64. See Compiling a universal binary on macOS.

Fixed issue where the limit for header/footer strings was 255 bytes instead of 255 characters and as a result UTF8 strings were being truncated.

Issue #305.

1.0.0 September 7 2020

Added support for worksheet conditional formatting. See worksheet_conditional_format_range() and Working with Conditional Formatting.

Feature request #32 and #302.
Added performance optimization for search for control characters in strings in worksheet_write_string().

Issue #298.
Made lxw_datetime_to_excel_datetime() a function public.

There are now over 1000 test cases, including 650 tests that compare the output from libxlsxwriter, byte for byte, against test files created in Excel. This is also the 100th release of libxlsxwriter.

0.9.9 August 17 2020

Added support for images in headers and footers. See worksheet_set_header_opt().
Added worksheet_ignore_errors() function to ignore Excel worksheet errors/warnings in user defined ranges.

0.9.8 August 11 2020

Added formatting for chart data labels and chart custom data labels. See Custom Chart Data Labels and chart_data_labels.c.

0.9.7 August 4 2020

Changed lxw_chart_data_label field from .delete to .hide in order to avoid reserved word conflict with C++. Issue #300.

0.9.6 August 3 2020

Added support for chart custom data labels. See Custom Chart Data Labels and chart_data_labels.c.
Fix for issue where array formulas weren't included in the output file for certain ranges/conditions. Issue #735.

0.9.5 May 31 2020

Fix for issue where hyperlinks urls and tips were ignored for worksheet_insert_image_buffer_opt() images. Issue #292.
Added LXW_CHART_LINE_STACKED and LXW_CHART_LINE_STACKED_PERCENT line charts subtypes.
Removed LXW_ERROR_SHEETNAME_RESERVED warning which was used with the reserved worksheet name "History". However, this is an allowed worksheet name in some Excel variants so the warning has been turned into a documentation note instead.

0.9.4 January 19 2020

Added option to specify worksheet "object positioning" for images and charts to define how they move or size with underlying cells. See Object Positioning with Cell Moving and Sizing and Working with Object Positioning.

0.9.3 January 13 2020

Fix Xcode/Cocoapods build warnings.

0.9.2 January 13 2020

Added support for writing cell comments, see Working with Cell Comments.
Makefile now respects DESTDIR and PREFIX, including when setting rpath on macOS.
Changed function names in bundled MD5 code to avoid conflicts with OpenSSL.

0.9.1 December 26 2019

Fix to missing MD5 linkage in Cocoapod file. Issue #259.

0.9.0 December 26 2019

Fix to avoid duplicate images being copied to an libxlsxwriter file. Excel uses an optimization where it only stores one copy of a repeated/duplicate image in a workbook. Libxlsxwriter didn't do this which meant that the file size would increase when then was a large number of repeated images. This release fixes that issue and replicates Excel's behavior.

Note, that this change adds a dependency on the Openwall MD5 library, which is now included with the libxlsxwriter third party source files. It is possible to compile libxlsxwriter without this library, and thus getting the older behavior, by passing USE_NO_MD5=1 to make.

0.8.9 December 16 2019

Added support for default hyperlink style in worksheet_write_url().
Added support for hyperlink in images, see worksheet_insert_image_opt().
Fixed several worksheet_write_url() edge cases.

0.8.8 November 17 2019

Added option to allow a user defined, or overridden, image description used with worksheet_insert_image(). By default it uses the filename as the description. Issue #238.
Added Windows portable version of fopen to handle utf8 filenames when working with images. Issue #238.
Added an option to allow chart fonts to be rotation to 270 deg to give a stacked orientation. Also added support for East Asian vertical chart fonts.
Refactored struct types used in pubic APIs to remove or document hidden fields. Note: This change introduces backward incompatible API changes. However, it should minimize any future changes of this nature. See issue #252.

0.8.7 June 20 2019

Added support for adding VBA macros to workbooks. These macros can be extracted from existing xlsm files, created in Excel, and added to new xlsm files. See Working with VBA Macros. Feature request #29.
Added support for ZIP64 extensions when writing very large xlsx files to allow the zip container, or individual XML files within it, to be greater than 4 GB. See workbook_new_opt(). Feature request #228.
Added extra validity checks on worksheet names. Issues #223 and #230.

0.8.6 April 7 2019

Fixed issue where images that started in hidden rows/columns weren't placed correctly in the worksheet.
Fixed the mime-type reported by system file(1). The mime-type reported by "file --mime-type"/magic was incorrect for XlsxWriter files since it expected the [Content_types] to be the first file in the zip container.

0.8.5 February 10 2019

Fix compile-time warnings with strict prototypes enabled. Issue #208.
Make py.test name configurable. Pull request #206.

0.8.4 November 10 2018

Fix for issue when hashing number formats. Issue #203.

0.8.3 October 1 2018

Added worksheet_write_rich_string() function to allow writing of multi-format rich strings. See rich_strings.c Feature request #37.

0.8.2 September 16 2018

Added new chartsheet functionality: chartsheet_set_tab_color(), and chartsheet_set_zoom().

0.8.1 September 15 2018

Fix for chartsheet and worksheet ordering issue.
Added new chartsheet functionality: chartsheet_protect(), chartsheet_hide(), chartsheet_select() and chartsheet_set_first_sheet().

0.8.0 September 12 2018

Added chartsheet support. A chartsheet is a type of worksheet that only contains a chart. See the Chartsheet object and chartsheet.c.

0.7.9 September 1 2018

Added chart_axis_set_label_align() function to set the alignment of chart category axis labels. Feature request #186.
Added lxw_version() function to get the library version. Feature request #194.

0.7.8 August 30 2018

Added worksheet_insert_image_buffer() function to insert images from memory buffers. See image_buffer.c. Feature request #125.

0.7.7 May 16 2018

Fix to ensure the use of wide filenames on Windows with Microsoft Visual C++. Issue #153.
Added docs on building an app with Cmake and Microsoft Visual C++ on Windows.

0.7.6 January 11 2018

Added support for worksheet Grouping and Outlines. See Working with Outlines and Grouping. Feature request #30.
Fix include of libxlsxwriter as a Cocoapod on macOS. Issue #94.

0.7.5 September 25 2017

Added support for data validations and dropdown lists. See Working with Data Validation and data_validate.c. Feature request #31.

0.7.4 August 20 2017

Fix make build system "install" target for compatibility with macOS brew/homebrew installer. See Installation on macOS with homebrew.

0.7.3 August 12 2017

Build system fixes for Gentoo. Issue #116.

0.7.2 July 26 2017

Changed font sizes from integer to double to allow fractional font sizes. Issue #114.

0.7.1 July 24 2017

Fixed issue where internal file creation and modification dates were in the local timezone instead of UTC. Issue #110.

0.7.0 June 26 2017

Added support for CMake build system. Thanks to Alex Huszagh.
Fixed issue where image filehandles weren't closed until the overall file was closed causing the system to run out of filehandles. Issue #106.

0.6.9 January 30 2017

Added chart trendlines. See Working with Chart Trendlines and chart_data_tools.c.

0.6.8 January 28 2017

Added chart error bars. See Working with Chart Error Bars and chart_data_tools.c.

0.6.7 January 24 2017

Added chart data labels. See Working with Chart Data Labels.

0.6.6 January 22 2017

Added functions to set chart Up-Down bars: see chart_set_up_down_bars() and chart_set_up_down_bars_format() and chart_data_tools.c.
Added functions to handle blank and hidden data in charts: see chart_show_blanks_as() and chart_show_hidden_data().

0.6.5 January 21 2017

Added functions to set the overlap and gap between series: see chart_set_series_overlap() and chart_set_series_gap().

0.6.4 January 20 2017

Added chart data table option, see chart_set_table() and chart_set_table_grid().
Added Clustered Chart example, see chart_clustered.c.

0.6.3 January 19 2017

Added chart_set_drop_lines() and chart_set_high_low_lines() functions to add chart Drop and High-Low lines to indicate category values. See chart_data_tools.c.

0.6.2 January 17 2017

Added chart_series_set_smooth() function to set the line smoothing property of a line or scatter chart series.

0.6.1 January 16 2017

Added option to set formatting for points in a chart. This allow the colors of Pie chart segments to be defined. See Working with Chart Points.

0.6.0 January 15 2017

Added option to set the number format for a chart axis, see chart_axis_set_num_format().
Added "invert if negative" option for series fills, see chart_series_set_invert_if_negative().

0.5.9 January 14 2017

Added support for chart axis crossing. See chart_axis_set_crossing() and chart_axis_set_crossing_max().

0.5.8 January 13 2017

Added chart_axis_set_major_tick_mark() and chart_axis_set_minor_tick_mark() functions to chart axis tick marks.

0.5.7 January 12 2017

Added chart_axis_set_display_units() function to set chart axis display units.

0.5.6 January 11 2017

Added chart_axis_set_interval_unit() and chart_axis_set_interval_tick() functions to adjust category axis intervals.

0.5.5 January 10 2017

Added chart_axis_set_major_unit() and chart_axis_set_minor_unit() to set the major and minor units of a category axis.

0.5.4 January 9 2017

Added chart_axis_set_label_position() option to position the axis labels (numbers).
Improved documentation for Chart Value and Category Axes.

0.5.3 January 8 2017

Added chart_axis_set_position() option to position a category axis horizontally on, or between, the axis tick marks.

0.5.2 January 7 2017

Added option to turn off chart axis: chart_axis_off().

0.5.1 January 6 2017

Added chart major and minor gridlines handling, see:

0.5.0 January 5 2017

Added chart and plot area formatting. See chart_chartarea_set_line() and chart_plotarea_set_line().

0.4.9 January 4 2017

Added support for chart patterns. See Chart formatting: Pattern.

0.4.8 January 3 2017

Added support for chart markers. See Working with Chart Markers.

0.4.7 January 2 2017

Added chart_axis_set_reverse() function to reverse the order of a chart axis.
Added chart_axis_set_min()and chart_axis_set_max() functions to set the minimum and maximum value for a chart axis.
Added chart_axis_set_log_base() function to set the log base of a chart axis. Feature request #70.

0.4.6 January 1 2017

Added functions to set chart line and fill properties, see:
- chart_series_set_line(). Feature request #83.
- chart_series_set_fill().
- chart_axis_set_line().
- chart_axis_set_fill().
- Chart formatting: Line.
- Chart formatting: Fill.

0.4.5 December 31 2016

Added functions to set chart legend properties: see chart_legend_set_position(), chart_legend_set_font() and chart_legend_delete_series().

0.4.4 December 30 2016

Added chart fonts. See chart_axis_set_name_font(), chart_axis_set_num_font(), chart_title_set_name_font() and Chart formatting: Fonts.

0.4.3 December 26 2016

Added workbook_get_worksheet_by_name() function to get a worksheet object from its name.
Added workbook_validate_worksheet_name() function to validate a worksheet name.
Fix for parameter length check when strings are UTF-8. Issue #84.

0.4.2 July 14 2016

Added support for OpenBSD and better support for FreeBSD. See Installation on FreeBSD and OpenBSD.

0.4.1 July 11 2016

Switched to using tmpfileplus for temporary file handles to work around issue when the temp directory on Windows isn't writeable. The temp file directory is now also configurable at runtime, see Specifying a TEMP directory for libxlsxwriter.

Issue #63.

0.4.0 July 5 2016

Added fixes for MSVC 2010.
Refactored public APIs to return lxw_error instead of int.

0.3.9 July 2 2016

Added support for MinGW, MinGW-w64, Cygwin, MSYS and MSYS2. See Installation on Windows using Mingw-w64 and MSYS2.

0.3.8 June 11 2016

Added workbook functions to set custom document properties. See workbook_set_custom_property_string() and doc_custom_properties.c.

0.3.7 June 2 2016

Added updated Cocoapods file for Cocoapods 1.0.0. This also add support for the "use_frameworks" directive. Thanks to Ludovico Rossi. See Getting Started with libxlsxwriter for instructions on how to use the cocoapod.

Pull request #50.

0.3.6 June 1 2016

Fix for worksheet_insert_image() issue when handling images with zero dpi.

0.3.5 May 31 2016

Refactored the error handling and reporting for when the file creation subsystem fails due to file permissions or other issues. The new error codes are in #lxw_error and the codes can be converted to strings, for reporting, using the new lxw_strerror() function.

Issue #49.

0.3.4 May 28 2016

Updated the Getting Started with libxlsxwriter docs with instructions on how to build libxlsxwriter for Windows using Microsoft Visual Studio and added links to the example MSVC project: MSVCLibXlsxWriter.

0.3.3 May 23 2016

Added support for charts via the The Chart object. See the examples of the supported chart types:
Feature request #36.

0.3.2 April 8 2016

Added the worksheet_write_boolean() function to write Excel boolean values. Feature request #47.

0.3.1 January 9 2016

Improved performance 20-30% for large data files.

0.3.0 January 4 2016

Renamed worksheet_set_row() function to worksheet_set_row_opt() for consistency with current and future APIs. The worksheet_set_row() function is now used without the options parameter.

Note: This is a backward incompatible change.
Renamed worksheet_set_column() function to worksheet_set_column_opt() for consistency with current and future APIs. The worksheet_set_column() function is now used without the options parameter.

Note: This is a backward incompatible change.

0.2.9 January 3 2016

Added the worksheet_insert_image() function to add PNG and JPG images to worksheets. See demo.c and images.c.

0.2.8 December 22 2015

Added worksheet_set_default_row() function to allow setting of default row height and hiding unused rows. See the hide_row_col.c example.

0.2.7 December 21 2015

Added support for escaping control characters in strings. This prevents unreadable files if string data contains control characters. Issue #42.

0.2.6 December 19 2015

Added worksheet_protect() function to protect Excel worksheet elements from modification. See the worksheet_protection.c example.

0.2.5 December 14 2015

Added workbook_set_properties() function to set Excel document properties such as Author and Title. See the doc_properties.c example.

0.2.4 December 13 2015

Added worksheet_hide() function to hide a worksheet. See the hide_sheet.c example.
Added worksheet_set_first_sheet() function to set the first visible worksheet in a workbook with a large number of worksheets.

0.2.3 December 12 2015

Added worksheet_set_tab_color() function to set the worksheet tab color. See the tab_colors.c example.

0.2.2 December 11 2015

Replaced shared strings hash table with a Red/Black tree implementation for better performance. Thanks to Martin Renters. Pull Request #41.

0.2.1 December 11 2015

Added worksheet_right_to_left() function. This can be used to change the default direction of the worksheet from left-to-right when creating Arabic, Hebrew or other near or far eastern worksheets that use right-to-left as the default direction.
Added worksheet_hide_zero() function to hide zero cell values.
Added worksheet_set_zoom() method to set the worksheet zoom factor.

0.2.0 December 9 2015

Added worksheet_set_selection() function to set the cell selected range on a worksheet.

0.1.9 December 7 2015

Replaced main worksheet data structure with a Red/Black tree implementation for better performance when data isn't added in linear row-column order. Thanks to Martin Renters. Pull Request #14 and #16.

0.1.8 December 7 2015

Added worksheet_freeze_panes() and worksheet_split_panes() to allow setting worksheet panes. See panes.c example.
Added link to Xcode project for iOS and OS X with Objective-C and Swift, provided by Ludovico Rossi.
Added improved support for Windows.

0.1.7 September 27 2015

Fixed Cocoapod spec file for iOS and OS X.

0.1.6 September 27 2015

Added Cocoapod spec file to allow the library to be installed using CocoaPods. Pull Request #7.

0.1.5 May 3 2015

Added worksheet_write_url() function to write urls/hyperlinks to worksheets. See also hyperlinks.c.

0.1.4 March 18 2015

Added worksheet_autofilter() function to add autofilters to worksheets. See also autofilter.c.

0.1.3 March 15 2015

Added worksheet_write_array_formula() function to allow writing of array formulas in worksheets.

0.1.2 March 14 2015

Added worksheet_set_h_pagebreaks() and worksheet_set_v_pagebreaks() functions to define worksheet page breaks.
Added LXW_FOREACH_WORKSHEET() macro to allow iteration over all the worksheets in a workbook.
Added worksheet_set_print_scale() function to set the scale factor for the printed page.
Added worksheet_set_start_page() function to set the start page number when printing.

0.1.1 March 13 2015

Added worksheet_print_area() function to control the print area of a worksheet.
Added worksheet_fit_to_pages() function to fit the printed area to a specific number of pages both vertically and horizontally.

0.1.0 March 12 2015

Added worksheet_repeat_rows() and worksheet_repeat_columns() functions to control the repeated rows/columns on printed worksheets.

0.0.9 March 9 2015

Added worksheet_gridlines() function to show/hide screen and print gridlines.
Added worksheet_center_horizontally() and worksheet_center_vertically() functions to center worksheet on the printed page.
Added worksheet_print_row_col_headers() function to enable printing of row and column headers.

0.0.8 March 8 2015

Added support for worksheet headers and footers via the worksheet_set_header() and worksheet_set_footer() functions. See also headers_footers.c.

0.0.7 March 7 2015

Added the worksheet_merge_range() method to merge worksheet cells. See also merge_range.c.

0.0.6 March 5 2015

Added the workbook_define_name() method to create defined names and ranges in a workbook or worksheet.

0.0.5 March 6 2015

Added worksheet_select() function to set worksheets as selected.
Added worksheet_activate() to set the active worksheet.
Several portability fixes to fix warnings with different compilers.

0.0.4 March 1 2015

Added worksheet_set_margins() function to set top, bottom, left and right margins in a worksheet.
Fix for issue where format objects were written to the file in the order of creation rather than the order of use. This issue caused incorrect formats in cells. Issue #3.
Fix for issue where tmp files in constant_memory mode weren't closed until application exited. Issue #1.

0.0.3 January 7 2015

Added worksheet page setup methods.

0.0.2 June 26 2014

First public release.

0.0.1 June 8 2014

First GitHub release.