{"id":13535722,"url":"https://github.com/CommunityToolkit/Lottie-Windows","last_synced_at":"2025-04-02T02:31:19.467Z","repository":{"id":37526563,"uuid":"156303754","full_name":"CommunityToolkit/Lottie-Windows","owner":"CommunityToolkit","description":"Lottie-Windows is a library (and related tools) for rendering Lottie animations on Windows 10 and Windows 11. ","archived":false,"fork":false,"pushed_at":"2025-02-06T00:12:30.000Z","size":25526,"stargazers_count":650,"open_issues_count":22,"forks_count":78,"subscribers_count":31,"default_branch":"main","last_synced_at":"2025-02-28T11:59:28.772Z","etag":null,"topics":["after-effects","animations","bodymovin","csharp","lottie","lottie-windows","uwp","windows","windows-10","windows-11","windows-toolkit","windows-ui-composition","winui","winui3"],"latest_commit_sha":null,"homepage":"https://aka.ms/lottiedocs","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CommunityToolkit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-11-06T00:45:54.000Z","updated_at":"2025-02-25T18:39:02.000Z","dependencies_parsed_at":"2024-04-02T21:53:13.585Z","dependency_job_id":"ee58f837-bd61-4435-b8ba-cbc02df17de2","html_url":"https://github.com/CommunityToolkit/Lottie-Windows","commit_stats":null,"previous_names":["windows-toolkit/lottie-windows"],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CommunityToolkit%2FLottie-Windows","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CommunityToolkit%2FLottie-Windows/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CommunityToolkit%2FLottie-Windows/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CommunityToolkit%2FLottie-Windows/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CommunityToolkit","download_url":"https://codeload.github.com/CommunityToolkit/Lottie-Windows/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246399795,"owners_count":20770908,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["after-effects","animations","bodymovin","csharp","lottie","lottie-windows","uwp","windows","windows-10","windows-11","windows-toolkit","windows-ui-composition","winui","winui3"],"created_at":"2024-08-01T09:00:24.090Z","updated_at":"2025-04-02T02:31:19.449Z","avatar_url":"https://github.com/CommunityToolkit.png","language":"C#","readme":"# Lottie-Windows\n\nLottie-Windows is a library for rendering [Adobe After Effects](https://www.adobe.com/products/aftereffects.html) animations natively in your application. This project adds Windows to the [Lottie](http://airbnb.io/lottie/) family of tools also targeting [Android](https://github.com/airbnb/lottie-android), [iOS](https://github.com/airbnb/lottie-ios), and [Web](https://github.com/airbnb/lottie-web).\n\nLottie simplifies the design-to-code workflow for bringing engaging, interactive vector animations to your Windows applications, with significant improvements in terms of performance, quality, and engineering efficiency over traditional approaches such as gifs, manually coded animations, etc. Lottie-Windows uses the [Windows.UI.Composition APIs](https://docs.microsoft.com/windows/uwp/composition/visual-layer) to provide smooth 60fps animations and resolution-independent vector graphics.\n\n![Lottie-Windows Gif](/images/LottieWindows_Intro.gif)\n\nLottie-Windows consists of 3 related products:\n* **[Lottie-Windows](/Lottie-Windows)** library for parsing and translating [Bodymovin](https://aescripts.com/bodymovin/) JSON files\n* **[LottieGen](/LottieGen)** command-line tool for generating C# or C++ code to be used instead of JSON\n* **[Lottie Viewer](/LottieViewer)** application for previewing JSON and also generating code \n\nThis repo also contains source code for **[samples](/LottieViewer)**.\n\n## \u003ca name=\"quickstart\"\u003e\u003c/a\u003e Quick start\n\nThere are **two** options to integrate Lottie animations into your **WinUI 3** or **UWP** project.\n\n**Option #1, using dynamic loader**\n1. Install `CommunityToolkit.WinUI.Lottie` nuget package for WinUI project (or `CommunityToolkit.Uwp.Lottie` for UWP project).\n2. If you are using C# you may also need to install `Microsoft.Graphics.Win2D` **(version 1.0.5 or below)** for WinUI project (or `Win2D.uwp` and `Microsoft.UI.Xaml` for UWP project).\n3. In your `.xaml` markup file add:\n    ```xml\n        ...\n        xmlns:lottie=\"using:CommunityToolkit.WinUI.Lottie\"\n        ...\n        \u003cAnimatedVisualPlayer\u003e\n            \u003clottie:LottieVisualSource UriSource=\"\u003casset path or web link to a json file\u003e\" /\u003e\n        \u003c/AnimatedVisualPlayer\u003e\n    ```\n    or for UWP project:\n    ```xml\n        ...\n        xmlns:muxc=\"using:Microsoft.UI.Xaml.Controls\"\n        xmlns:lottie=\"using:CommunityToolkit.Uwp.Lottie\"\n        ...\n        \u003cmuxc:AnimatedVisualPlayer\u003e\n            \u003clottie:LottieVisualSource UriSource=\"\u003casset path or web link to a json file\u003e\" /\u003e\n        \u003c/muxc:AnimatedVisualPlayer\u003e\n    ```\n**Option #2, using codegen (recommended)**\n1. Install codegen tool using `dotnet tool install lottiegen` in powershell\n2.  Run codegen tool `lottiegen -InputFile MyAnimation.json -Language cs -WinUIVersion 3.0`\n    - For UWP projects use `-WinUIVersion 2.X` depending on the version of `Microsoft.UI.Xaml`\n    - Other language options: `cppwinrt` and `cppcx`\n3. Add generated source files to the project\n4. Install packages from step 2 of Option #1 if needed.\n5. In your `.xaml` markup file add:\n    ```xml\n        ...\n        xmlns:animatedvisuals=\"using:AnimatedVisuals\"\n        ...\n        \u003cAnimatedVisualPlayer\u003e\n            \u003canimatedvisuals:MyAnimation/\u003e\n        \u003c/AnimatedVisualPlayer\u003e\n    ```\n    or for UWP project:\n    ```xml\n        ...\n        xmlns:muxc=\"using:Microsoft.UI.Xaml.Controls\"\n        xmlns:animatedvisuals=\"using:AnimatedVisuals\"\n        ...\n        \u003cmuxc:AnimatedVisualPlayer\u003e\n            \u003canimatedvisuals:MyAnimation/\u003e\n        \u003c/muxc:AnimatedVisualPlayer\u003e\n    ```\n\n## \u003ca name=\"supported\"\u003e\u003c/a\u003e Supported SDKs\n* May 2019 Update (18362) and later\n\n## \u003ca name=\"documentation\"\u003e\u003c/a\u003e Documentation\n* [Documentation and Tutorials](https://aka.ms/lottiedocs)\n* [Lottie Samples](https://aka.ms/lottiesamples)\n* [Lottie Viewer](https://aka.ms/lottieviewer)\n\n## Build Status\n| Package | Branch | Status | Latest nuget version |\n| ------ | ------ | ------ | ------ |\n| CommunityToolkit.WinUI.Lottie | main | [![Build Status](https://dev.azure.com/dotnet/WindowsCommunityToolkit/_apis/build/status/Microsoft.Toolkit.Uwp.UI.Lottie?branchName=main)](https://dev.azure.com/dotnet/WindowsCommunityToolkit/_build/latest?definitionId=61\u0026branchName=main) | [![NuGet](https://img.shields.io/nuget/v/CommunityToolkit.WinUI.Lottie.svg)](https://www.nuget.org/packages/CommunityToolkit.WinUI.Lottie/) |\n| CommunityToolkit.Uwp.Lottie | main | [![Build Status](https://dev.azure.com/dotnet/WindowsCommunityToolkit/_apis/build/status/Microsoft.Toolkit.Uwp.UI.Lottie?branchName=main)](https://dev.azure.com/dotnet/WindowsCommunityToolkit/_build/latest?definitionId=61\u0026branchName=main) | [![NuGet](https://img.shields.io/nuget/v/CommunityToolkit.Uwp.Lottie.svg)](https://www.nuget.org/packages/CommunityToolkit.Uwp.Lottie/) |\n| LottieGen | main | [![Build Status](https://dev.azure.com/dotnet/WindowsCommunityToolkit/_apis/build/status/Microsoft.Toolkit.Uwp.UI.Lottie?branchName=main)](https://dev.azure.com/dotnet/WindowsCommunityToolkit/_build/latest?definitionId=61\u0026branchName=main) | [![NuGet](https://img.shields.io/nuget/v/LottieGen.svg)](https://www.nuget.org/packages/LottieGen/) |\n\n\n\n## Feedback and Requests\nPlease use [GitHub Issues](https://github.com/windows-toolkit/Lottie-Windows/issues) for bug reports and feature requests.\n\n## Principles\nThis project has adopted the code of conduct defined by the [Contributor Covenant](http://contributor-covenant.org/)\nto clarify expected behavior in our community.\nFor more information see the [.NET Foundation Code of Conduct](http://dotnetfoundation.org/code-of-conduct).\n\n## .NET Foundation\nThis project is supported by the [.NET Foundation](http://dotnetfoundation.org).\n","funding_links":[],"categories":["Libraries","C#"],"sub_categories":["Creation Tools"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCommunityToolkit%2FLottie-Windows","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCommunityToolkit%2FLottie-Windows","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCommunityToolkit%2FLottie-Windows/lists"}