avail/NetLimiter.AutoPatch

A curated list of arrrrrrrrr!

Preamble

Over the past couple of years, I've accumulated bookmarks, saved Reddit posts, and GitHub stars all related to piracy in some form or another. This list is my attempt to add structure to those resources and share them. Everything you need to get started on your pirate voyage can be found below.

I am aware that a number of websites featured in this list rely on operating under obscurity, and that this list could potentially contribute to their demise through excess exposure. I'm sorry about that - I just like making lists.

Please ensure you use an adblocker like uBlock Origin to access any of the websites listed here, otherwise, you will have a bad time.

For discussion and feedback, please head to the Reddit thread on /r/Piracy. If you come across dead links, please report them by creating an issue.

How to use this list

Some items in this list could easily fit in more than one category, so to make sure you find what you're looking for please use (or on macOS).

Emoji

You will notice some items on this list have a :star2: next to them. Items with a :star2: represent the author's top pick for that category. This is an entirely opinionated rating from someone who doesn't know everything about every item on the list, so be sure to check out alternative options before assuming something is "the best". That said, I do explore and test every resource I add to this list wherever possible.

Background Information

Contents

VPNs

VPN Guides and Tutorials

VPN Subscription Services

• Private Internet Access :star2: Hugely popular subscription-based VPN provider with a proven track record for not keeping logs
• Mullvad A Bitcoin-friendly, privacy-first VPN.
• ProtonVPN High-speed Swiss VPN that safeguards your privacy.
• NordVPN With NordVPN, encrypt your online activity to protect your private data from hackers or snoopy advertisers.
• Windscribe Simple VPN, has a free plan that gives you 10gb/mo bandwidth, paid version even has port forwarding for static IPs, privacy-focused.
• ExpressVPN VPN with 256-bit encryption, 94 countries, and no logs. It is also rated as one of the fastest VPNs out there.

Self-hosted VPNs

• n2n Peer-to-peer VPN
• PeerVPN PeerVPN is a software that builds virtual ethernet networks between multiple computers.
• OpenVPN :star2: OpenVPN provides flexible VPN solutions to secure your data communications, whether it's for Internet privacy, remote access for employees, securing IoT, or for networking Cloud data centers.
• Nebula A scalable overlay networking tool with a focus on performance, simplicity and security
• Pritunl Enterprise Distributed OpenVPN and IPsec Server
• WireGuard VPN WireGuard is an extremely simple yet fast and modern VPN that utilizes state-of-the-art cryptography. It aims to be faster, simpler, leaner, and more useful than IPSec.
• sshuttle Transparent proxy server that works as a poor man's VPN.
• ZeroTier Peer-to-peer multi-platform VPN
• Outline by Alphabet Not exactly a VPN, but is strong in privacy and security. Works with DO, Google Cloud, AWS and more.
• Mysterium Network Open-source VPN client and server software. It can be used to sell your spare bandwidth for cryptocurrency.
• tinc Peer-to-peer VPN software with mesh routing.
• OpenConnect Multiplatform VPN compatible with Cisco's AnyConnect. Uses well-tested, standard TLS connections which easily bypass DPI.
• Shadowsocks Secure SOCKS proxy used in China for bypassing the Great Firewall.

Browser Extensions

• Decentraleyes Protects against tracking with a local CDN (Content Delivery Network) emulation.
• Privacy Badger Privacy Badger blocks spying ads and invisible trackers.
• HTTPS Everywhere HTTPS Everywhere is a Firefox, Chrome, and Opera extension that encrypts your communications with many major websites, making your browsing more secure.
• uBlock Origin :star2: An efficient blocker for Chromium and Firefox. Fast and lean.
• TamperMonkey The world's most popular userscript manager
• WebRTC Network Limiter Configures how WebRTC's network traffic is routed by changing Chrome's privacy settings.
• ScriptSafe A browser extension that gives users control of the web and more secure browsing while emphasizing simplicity and intuitiveness.
• NoScript Allow active content to run only from sites you trust, and protect yourself against XSS and clickjacking attacks. Firefox only.
• Burlesco Read the news without subscribing, bypass the paywall
• Universal Bypass Universal Bypass automatically skips annoying link shorteners.
• Violentmonkey An open-source userscript manager.
• Anti-Paywall A browser extension that maximizes the chances of bypassing paywalls
• Google Unlocked Uncensor google search results.

Userscripts

• IMDb Scout Add links from IMDb pages to torrent sites -- easy downloading from IMDb
• IMDb Scout Mod Adds links to IMDb pages from the torrent, ddl, subtitles, streaming, usenet and other sites.
• AdsBypasser This user script helps you to skip countdown ads or continue pages and prevent ad pop-up windows.
• AntiAdware Remove forced download accelerators, managers, and adware on supported websites
• Direct download from Google Play Adds APKPure, APKMirror and Evozi download buttons to Google Play when browsing apps.
• AdGuard Popup Blocker Popup Blocker by AdGuard is a userscript that blocks all unwanted pop-up windows in different browsers.
• Torrentz2 Magnet Add magnet link to torrentz2
• Bypass paywalls for scientific documents This script adds download buttons on Google Scholar, Scopus, and Web Of Science, which lead to sci-hub.tw.
• Google Image "View Image" button Add "View Image" button. This is a fork of the original.
• MAL-Sync Integrates MyAnimeList into various sites, with auto episode tracking.
• Remove fake TPB torrents Script that automatically hides fake torrents on The Pirate Bay based on conditional logic.
• Get DLC Info from SteamDB For use with CreamAPI and similar tools.
• The Pirate Bay Cleaner Auto-sorting, torrentifying, theme-change, search-change, SSL/HTTPS and more.

Password Vaults

• BitWarden :star2: Open source password management solution, can be self-hosted
• 1Password Popular cloud-hosted password manager
• KeePass Free, open source, light-weight, and easy-to-use password manager.
• LastPass LastPass remembers all your passwords, so you don't have to.
• Pass Simple GPG/Git password manager. Follows the Unix philosophy.
• Dashlane An intuitive password manager with over with over 8 million users worldwide.
• Passbolt Free, open source, self-hosted, extensible, OpenPGP based.
• LessPass Stateless open source password manager
• Psono Open source and self-hosted password manager for teams
• Buttercup Another open source password manager with desktop, mobile, and browser clients.

Antivirus

Privacy

• Prism Break Opt out of global data surveillance programs like PRISM, XKeyscore, and Tempora.
• /r/privacy The intersection of technology, privacy, and freedom in a digital world.
• Any Soft Keyboard A privacy-focused keyboard

Windows 10 Privacy

• O&O ShutUp10 O&O ShutUp10 means you have full control over which comfort functions under Windows 10 you wish to use, and you decide when the passing on of your data goes too far.
• Windows 10 Privacy Guide :star2: an In-depth guide on purging Windows 10 of Microsoft's attempts to track you
• Windows Privacy Tweaker Freeware app from phrozen.io
• Winaero Free, small and useful software for Windows.
• WPD The real privacy dashboard for Windows
• Destroy-Windows-10-Spying Destroy Windows Spying tool
• Tron Tron, an automated PC cleanup script
• Tallow Tallow is a transparent Tor firewall and proxying solution for Windows.

Email

Decentralised Networks

• Tor :star2: Tor is free software and an open network that helps you defend against traffic analysis.
• I2P I2P is an anonymous overlay network - a network within a network. It is intended to protect communication from dragnet surveillance and monitoring by third parties such as ISPs.
• Freenet Freenet is free software which lets you anonymously share files, browse and publish "freesites" (web sites accessible only through Freenet) and chat on forums, without fear of censorship.
• Zeronet Open, free and uncensorable websites, using Bitcoin cryptography and BitTorrent network
• Loki Lokinet is an anonymous, decentralized and IP based overlay network for the internet.
• IPFS A peer-to-peer hypermedia protocol designed to make the web faster, safer, and more open.
• Yggdrasil Makes use of a global spanning tree to form a scalable IPv6 encrypted mesh network.

Operating Systems

• Qubes OS Qubes OS is a security-oriented operating system
• Tails Tails is a live operating system that you can start on almost any computer from a USB stick or a DVD.

Domain Names

• Njalla a privacy-aware domain registration service
• xip.io magic domain name that provides wildcard DNSfor any IP address.
• Domainr Domainr finds domain names and short URLs. Instantly check availability and register for all top-level domains.

Torrenting

• /r/torrents Questions and discussion about all things torrent-related
• BitTorrent Wikipedia's article on the BitTorrent file sharing protocol
• Live Tracer Pre-time tracer for scene releases
• magent2torrent.me Converts magnet links to torrent files
• mgnet.me Magnet URI shortener
• Torrent🧲Parts - Inspect and edit what's in your Torrent file or Magnet link
• Torrage Torrage is a free service for caching torrent files online.
• peerflix Google Search Searches Heroku-deployed instances of Peerflix for streaming torrents
• Torznab Newznab-like API offering a standardized recent/search API for both TV and movies
• xbit Magnet link repository
• torrents.csv Torrents.csv is a collaborative repository of torrents, consisting of a single, searchable torrents.csv file.
• torrents-csv.ml The above torrents.csv hosted.
• mktorrent mktorrent is a simple command line utility to create BitTorrent metainfo files.
• Torrent Paradise IPFS-based decentralised torrent search engine.
• torrent.nz Torrent.nz is a magnet torrent search engine.
• magnetico Autonomous (self-hosted) BitTorrent DHT search engine suite

Trackers

• /r/trackers :star2: A subreddit for discussing public & private trackers.
• A Simple Guide To A Better Ratio A good tracker requires you to upload what you download. This guide explains many of the methods involved with keeping on top of this sometimes difficult task.
• Tracker Twitters List Of Private Torrent Trackers & BitTorrent News Accounts To Follow On Twitter
• Bravo List Tracker directory

Private Trackers

• AlphaRatio (AR) :star2: A good starter tracker with lots of freeleech content.
• AnimeBytes (AB) community centralized around Japanese media, including anime, manga, and music
• Audionews (AN) Private torrent tracker for music production audio. (DJ apps, audio editor, DAW apps, etc) Open signups on the 1st-2nd every month.
• Awesome HD (AHD) Awesome-HD is a private tracker for quality enthusiasts.
• BakaBT (BBT) a torrent tracker which specializes in serving anime fans
• Bibliotik (BI) Popular ebooks/audiobooks private tracker
• Bitspyder (BS) Bitspyder is an educational torrent site devoted to e-Learning content such as e-Books, video courses, and audiobooks.
• Blutopia (BLU) Blutopia is a private tracker for HD movies and HD TV shows.
• CGPeers (CGP) CGPeers is a private torrent tracker for all things computer graphics: tutorials, graphics software, 3D, visual effects, design, and computer-assisted art.
• Filelist (FL) Large Romanian general tracker with mostly English content. No RAR files allowed. (Scene torrents are unrared, and then allowed.)
• GazelleGames (GGn) Currently the largest private tracker for games.
• HD4Free (HD4F) HD4Free is a general HD tracker with a good range of content. It is a ratioless tracker so it is great for beginners. Note that any adult content/porn is strictly prohibited there.
• HD-Forever (HD-F) HD-Forever is a French private tracker for HD movies.
• HD-Space (HDS) HD-Space is a private torrent tracker hosting HD movies, TV shows, and music torrents. Good tracker for beginners.
• IPTorrents (IPT) Private tracker with movies, books, and more.
• JPopsuki (JPop) JPopsuki is a torrent tracker focused on Asian music.
• MyAnonaMouse (MAM) Private E-Learning tracker with about 360 000 torrents including audiobooks, e-learning, musicology, and radio.
• MySpleen (MS) MySpleen is a private tracker which specialises in comedy, animation, and TV series.
• Nostalgic Torrents (NT) Private tracker for anime, comics/manga, documentaries, movies, TV - PRE 2013, TV - PRE 2009 With Original Commercials, etc. Also known as The-Archive and HeyNow.
• PassThePopcorn (PTP) ratio-based torrent tracker for movies
• PolishTracker (PT) PolishTracker is the oldest private Polish tracker existing to this day
• PolishSource (PS) PolishSource is a big private Polish ratio-less tracker
• PrivateHD (PhD) PrivateHD is a private BitTorrent tracker focused on high definition movies and TV show torrents.
• Redacted (RED) Largest private music tracker at 1.5 million torrents.
• TheGeeks (TGBZ) Private tracker for e-learning
• TorrentLeech (TL) Well-known popular private tracker
• TVChaos UK (TVCUK) Private tracker for British television
• UHDBits (UHD) UHDBits is a Vietnamese private torrent tracker focused on HD movies and TV shows.
• WorldOfP2P (WOP) Private tracker for Movies, TV, and General.
• /PTG tracker manifesto List of private trackers
• 0QoLttS.jpg Screenshot of a table from somewhere of private trackers and their sign-up requirements
• Private Tracker Flowchart V4 of the private tracker flowchart. Somewhat out of date.
• Private trackers Guide on how to get into (and survive) the world of private trackers.
• RED Interview Prep This site was written as a guide for potential users to learn about music formats, transcodes, torrenting, and burning and ripping — everything you need to know to pass the RED interview.
• Tracker Spreadsheet Comprehensive spreadsheet of private trackers (somewhat out of date)

Semi-Private Trackers

• ruTracker :star2: RuTracker is a huge Russian torrent site with a thriving file-sharing community.
• Zamunda.net A Bulgarian tracker with English and Russian translations available.
• ArenaBG A Bulgarian tracker with an English translation available.
• NoNaMe Club Russian semi-private tracker and forum
• MetalArea Russian (someplaces english) tracker for obscure metal and dungeon synth.

Public Trackers

• 1337x 1337x is a torrent site that offers verified torrent downloads.
• ETTV ETTV is a torrent site specific for movie torrents.
• EZTV EZTV is a torrent site for TV shows founded by TV-torrent distribution group EZTV.
• Isohunt2 Clone of the original isoHunt torrent index and repository
• KickAss Torrents Community-made reincarnation launched in 2016
• RARBG :star2: Public tracker with its own release group
• YTS Small-size HD movies from YIFY
• The Pirate Bay Infamous torrent site which is somehow still running, blocked in most places but can be accessedvianumerousproxysites
• The Proxy Bay Can't access The Pirate Bay? Try one of these proxy sites.
• Idope (Clone) iDope is a torrent search engine presenting direct magnet links, comments and up to date seeder/leecher statistics.
• Torrentz2 A good replacement of the defunct Torrentz.eu othermirrors
• Zooqle Zooqle is a relatively new torrent index providing a huge database of verified torrents.
• rutor Russian tracker
• GloTorrents Download Movies, TV, Games and Other Torrents Free
• BTDB Large BitTorrent DHT search engine
• BTDigg BTDigg is a popular BitTorrent DHT search engine.
• trackerslist An updated list of public BitTorrent trackers
• MagnetDL Magnet link only search engine
• TorrentGalaxy Public tracker with a clean UI which now supports embedded streaming for internal uploads
• Games4theworld Torrents and magnet links for games
• metal-tracker.com Heavy metal music tracker
• SkyTorrents Revival of the recently-shut-down, privacy-focused, ad-free torrent indexer
• Pirateiro Pirateiro is a torrent index for Brazilian and Portuguese torrents.
• TorrentKing Torrentking is a popular movie torrent site.
• moviemagnet Verified torrents for movies.
• Zonatorrent Spanish tracker
• TorrentFunk TorrentFunk is a torrent site providing verified torrents for all kinds of content.
• OTorrents Yet another public torrent tracker
• Torlock Torlock is a torrent index and torrent search that helps to access the latest in TV series and movies.
• DIGBT DIGBT is a DHT torrent search engine.
• Torrent9 French torrent search engine
• YggTorrent French tracker and search engine (have a download/upload ratio limitation)
• WorldWide Torrents Another public tracker with a reasonably nice UI
• Rock Box Metal music tracker
• Music Torrent General music tracker
• 7torrents Fast, clean, ad-free, privacy-focused DHT search engine

Tracker Aggregators

• snowfl snowfl is a torrent aggregator which searches various public torrent indexes in real-time
• Torrents.me Torrents.me combines popular torrent sites and specialized private trackers in a torrent multisearch.
• rats-search P2P Bittorrent search engine
• AIO Search Torrent search engine
• SolidTorrents :star2: A clean, privacy focused torrent search engine.

Tracker Proxies

• Jackett API Support for your favorite torrent trackers.
• Cardigann A proxy server for adding new indexers to Sonarr, SickRage, and other media managers
• nzbhydra2 :star2: Primarily a Usenet metasearch engine but also supports Torznab

Tracker Invites

Torrent Clients

• qBitTorrent Popular, lightweight, multi-platform torrent client
• qBitTorrent search function Allows you to search popular trackers directly from qBittorrent
• qBitTorrent plugins for public sites List of qBitTorrent plugins for searching public torrent sites.
• Transmission Default torrent client in many distros.
• Popcorn Time Popcorn Time is a multi-platform, free software BitTorrent client that includes an integrated media player.
• Butter Project A legal fork of Popcorn Time which is configurable to allow for custom sources of video
• BitLord Another BitTorrent streaming client
• Tixati Lightweight torrent client for Windows and Linux
• PicoTorrent A lightweight and minimalistic torrent client for Windows
• FrostWire FrostWire is a Free and open-source BitTorrent client first released in September 2004, as a fork of LimeWire.
• peerflix Streaming torrent client for node.js
• RapidBay Rapid bay is a self-hosted video service/torrent client that makes playing videos from torrents easy.
• Tornado Tornado is a modern web-first BitTorrent client designed with usability in mind. Based on Transmission.

Deluge

• Deluge :star2: Deluge is a lightweight, Free Software, cross-platform BitTorrent client.
• AutoRemovePlus Auto removing of deluge torrents
• ltConfigltConfig is a plugin for Deluge that allows direct modification to libtorrent settings and has preset support.
• Deluge Plugins List of official and third-party plugins for Deluge

rTorrent

• rTorrent :star2: rTorrent is a text-based ncurses BitTorrent client written in C++
• ruTorrent Yet another web front-end for rTorrent
• rTorrent Community wiki GitHub wiki for rTorrent
• rTorrent Docs Comprehensive manual and user guide for the rTorrent bittorrent client
• rutorrent-themes A collection of default and new, original themes for ruTorrent.
• flood A web UI for rTorrent with a Node.js backend and React frontend.
• rTorrent ArchWiki Page Detailed article to answer most common questions about rTorrent
• rTorrent Seedbox Guide This guide is a single-page, comprehensive guide to take you step-by-step through installation and configuration.
• rtorrent-ps Extended rTorrent distribution with a fully customizable canvas and colors, other feature additions, and complete docs.
• pyrocore A collection of tools for the BitTorrent protocol and especially the rTorrent client
• rTorrent research security modifications and other hacks for usability
• rutorrent-all-seeders This ruTorrent plugin adds the columns 'All Seeders' to the torrents list.

WebTorrent Clients

• magnetoo Fancy new in-browser WebTorrent streaming service
• βTorrent fully-featured WebTorrent browser client written in HTML, JS and CSS
• WebTorrent Desktop WebTorrent Desktop is for streaming torrents.
• Instant.io Streaming file transfer over WebTorrent (torrents on the web)

autodl-irssi

• autodl-irssi autodl-irssi is a plugin for irssi that monitors IRC announce channels for torrent trackers and downloads torrent files based on user-defined filters.
• autodl-curl-sonarr Script to use as upload-command for autodl-irssi to post to Sonarr
• mreg Generates a "Match releases" expression for your autodl-irssi filter based on dvdsreleasedates.com's "Most Requested DVD Release Dates" section.
• Slack notifications for autodl-irssi Guide by yours truly on enabling Slack notifications for autodl-irssi

Seedboxes

• /r/seedboxes A place to discuss seedboxes and everything related to them.
• SeedSync SeedSync is a GUI-configurable, LFTP-based file transfer and management program.

Web-based Cloud Seedboxes

• Seedr Essentially a seedbox you can paste torrents into which returns a streamable direct link
• ZXCFiles A similar service that allows you to paste magnet links or upload torrent files and get a DDL. The first 20GB are free.
• Bitport.io Another direct download site for pasting magnet links or .torrent files. Free accounts offer 1GB for free.
• Torrent Safe Free plan includes 1GB max file size, 2 days file lifetime. Discounts for paid subscriptions pop up on their Facebook page
• Furk.net Free trial offers 1GB per day or 5GB per week if you can get an invite/voucher or use Facebook
• FileStream.me The free subscription offers 200Mb max file size and 200GB storage total
• 2Giga.link
• Foxleech No free trial, plans start at $3 per month
• Boxopus No free trial, plans start at $0.99 per day
• Put.io $0.99 1 day trial
• Put.io automator A suite of commands for managing torrents, transfers, and files on Put.IO

Seedbox Hosting Providers

• novaDedi novaDedi formerly known as metaDedi was created to help to find you the cheapest dedicated server for your intended use case.
• CheckServers.OVH Checks the availability of OVH servers.
• Kimsufi Affordable dedicated servers
• Online.net :star2: Seedbox-friendly, affordable, dedicated server host
• Hetzner Reliable and affordable server host
• /u/Andy10gbit Reddit user with good deals on servers and seedboxes
• Bytesized Hosting "The best Plex server hosting in town"
• FeralHosting Shared seedbox hosting provider
• Whatbox Whatbox is a BitTorrent CDN
• Seedboxes.cc Reliable and affordable web hosting, with the power of your friendly monsters!
• UltraSeedbox "Plex optimized" servers to rent
• SeedHost "Seedhost.eu is the oldest continuously operating seedbox hosting provider on the internet."
• Chmuranet Chmuranet is a small private boutique seedbox provider.
• Xirvik Preconfigured seedbox servers
• OVH Large cloud server provider
• SoYouStart Another dedicated server host
• PulsedMedia Inexpensive seedbox provider
• Cloudboxes.io Seedboxes with impressive 20Gbps uplinks
• Seedbox.io Shared and dedicated slots with 1Gbps+ uplinks
• Giga-Rapid.com Shared 1Gbps seedboxes with massive storage & lots of addon applications.

Seedbox Setup Tools and Guides

• swizzin a light, modular package management suite for media-oriented servers
• Seedbox Guide comparison tool to help you find the best fitting Seedbox
• rtinst seedbox installation script for Ubuntu and Debian systems
• sboxsetup Another seedbox setup script
• QuickBox IO Seedbox installer script
• MediaServer-DockerComposeFiles Docker-Compose Files for Media Server Related Apps [Radarr, Sonarr, Plex, rTorrent, NZBGet, Ombi, Emby, etc]
• usenet-docker Docker-compose configuration for Sabnzbd, CouchPotato, Plex, Sonarr, Plexpy, Nzbhydra, Muximux, Radarr, NZBGet and Ombi with an Nginx proxy.
• DockSTARTer DockSTARTer helps you get started with home server apps running in Docker.
• OpenFLIXR OpenFLIXR Media Server is an all-in-one media server for automated downloading and serving media.

Tracker Frameworks

• Torrent-Tracker-Platforms A Curated List Of Torrent Tracker Platforms/Codebases Written In Multiple Coding Languages
• UNIT3D The Nex-Gen Private Torrent Tracker (Aimed For Movie / TV Use)
• meanTorrent A BitTorrent Private Tracker CMS with Multilingual, and IRC announce support, Cloudflare support.
• NexusPHP BitTorrent private tracker scripts written in PHP.
• Gazelle :star2: web framework geared towards private torrent trackers with a focus on music
• opentracker Opentracker is an open and free BitTorrent tracker project.

Usenet

• Usenet Usenet is a worldwide distributed discussion system available on computers.
• Usenet newsgroup A Usenet newsgroup is a repository usually within the Usenet system, for messages posted from many users in different locations using the Internet.
• /r/Usenet :star2: a thriving community dedicated to helping users old and new understand and use Usenet.
• /r/UsenetInvites Requests and offers for Usenet indexers
• NZBLINK The NZBLNK™ URI scheme defines the format of NZBLNK™ links to identify binary Usenet content and supplies some extra information to handle that content correct (similar to magnet links, but for NZBs).
• Usenet-Uploaders Table of applications for uploading content to Usenet
• QuickPar Tool for reconstructing damaged/missing/corrupt Usenet binaries
• NZB Monkey NZB download helper-tool
• SABconnect++ Chrome extension which adds one-click 'Send to SABnzbd' buttons to many popular NZB index sites.

Usenet Providers

Usenet Indexers

Usenet Indexing Software

• nZEDb a fork of nnplus(2011)

  Shopware 6 Changelog

  Changelog

  Important note

  If problems with the Shopware Store occur in the administration, the plugin should be updated manually. This can be easily done in the administration under Extensions > My Extensions.

  
  

  Brexit Changes

  With this release, you can select per country whether the customer needs to provide a VAT ID or not. Therefore, you should check these settings after the update.

  
  NEXT-7321 - Changed location where category criteria is built to be queried in the category detail component.
  NEXT-11376 - Make HTML attributes accessible to `sw-text-field` component.
  NEXT-11390 - The name of profiles in the Import/Export module now also works with other languages
  NEXT-11699 - Widget pages are now no longer indexed
  NEXT-11834 - When moving a category to another category, the assigned products are now automatically re-indexed in the background.
  NEXT-12857 - The image carousel in the storefront is now displayed correctly again
  NEXT-13107 - Fixed a bug in the SEO URL generation for new Sales Channel.
  NEXT-15568 - Reloads rule builder rules when changing the payment method of an order
  NEXT-15586 - The titles and descriptions of extensions in the "My Extensions" section are now always displayed in the interface language of the administration.
  NEXT-15692 - The performance of listing queries was optimized for systems where the SQL server had problems determining the correct indices.
  NEXT-15703 - Contact form shopping experience element receives recipient settings from Category-Layouts when shopping experience is of type landing page
  NEXT-15717 - Added sales channel cleanup task
  NEXT-15730 - Fixed zoom gesture in the Storefront
  NEXT-15731 - Make the order of two column text elements consistent for shopping experience layouts
  NEXT-15739 - Added option skip parameter to dal:refresh:index to skip one or more indexers in the process
  NEXT-15747 - Change `sw-url-field` component to allow hash and search paramters
  NEXT-15765 - Labels for filters of Visibilities in Product Streams
  NEXT-15774 - The last time, when you changed the new configuration for displaying property at the storefront, it won't be updated immediately and still displaying the old one. This update will solve this issue above
  NEXT-15790 - Custom field sorting criterias are only being saved once completely configured
  NEXT-15808 - Keep searchTerm in store visible after navigation
  NEXT-15809 - Fix for registration with different shipping address and selection between company and customer account
  NEXT-15823 - A problem was solved that prevented the resubscription to an newsletter with activated double-pt-in. (apfelbox)
  NEXT-15825 - Warning that the category having as an initial entry point cannot be deleted
  NEXT-15851 - Fixes the sorting by price of different currency in administration product listing
  NEXT-15890 - Display full product names for new and existinging associations in cross selling grid
  NEXT-15891 - The variant characteristics are now displayed in the storefront cross selling sliders.
  NEXT-15892 - It is no longer possible to add variant parent products to Cross Selling Definition.
  NEXT-15895 - Added event for Criteria in Sales Channel Repository
  NEXT-15941 - The custom field single select now safes option labels again
  NEXT-15946 - The search in the newsletter recipient module has been fixed. (nexxome)
  NEXT-15970 - Allows assignment of products to sales channel by category, when the root category is of type entry point
  NEXT-15971 - The price field in the administration has been corrected so that due to a programmatic inaccuracy in the programming language javascript, prices like 5.0337000001 can no longer arise.
  NEXT-15974 - Adjusted behavior for extensions in CMS block navigator
  NEXT-15977 - Allows expanding of categories after changing position by drag'n'drop
  NEXT-15990 - Added option to permentaly disable the warning prompt in the CMS navigator
  NEXT-16004 - Added global styling for external links
  NEXT-16005 - * Alter "pumpkin-spice" colour scheme to increase readability * Adjust styling of sw-alert component to suit design specs.
  NEXT-16019 - Image slider in product detail can scroll vertical smoothly on mobile device
  NEXT-16139 - Users can be deleted, even if they created or edited an order over the administration.
  NEXT-16141 - Fixed a bug in the product search indexing that caused all custom fields to be indexed as soon as a custom field was configured for the search.
  NEXT-16183 - Fixed product exports via scheduler, when using multiple Storefront Sales Channels
  NEXT-16203 - Fix style for blank target button links
  NEXT-16241 - Corrected checkout error messages
  = ImGuiConfigFlags_NavEnableKeyboard to enable. NewFrame() will automatically fill io.NavInputs[] based on your io.KeysDown[] + io.KeyMap[] arrays. - When keyboard navigation is active (io.NavActive + ImGuiConfigFlags_NavEnableKeyboard), the io.WantCaptureKeyboard flag will be set. For more advanced uses, you may want to read from: - io.NavActive: true when a window is focused and it doesn't have the ImGuiWindowFlags_NoNavInputs flag set. - io.NavVisible: true when the navigation cursor is visible (and usually goes false when mouse is used). - or query focus information with e.g. IsWindowFocused(ImGuiFocusedFlags_AnyWindow), IsItemFocused() etc. functions. Please reach out if you think the game vs navigation input sharing could be improved. - Mouse: - PS4 users: Consider emulating a mouse cursor with DualShock4 touch pad or a spare analog stick as a mouse-emulation fallback. - Consoles/Tablet/Phone users: Consider using a Synergy 1.x server (on your PC) + uSynergy.c (on your console/tablet/phone app) to share your PC mouse/keyboard. - On a TV/console system where readability may be lower or mouse inputs may be awkward, you may want to set the ImGuiConfigFlags_NavEnableSetMousePos flag. Enabling ImGuiConfigFlags_NavEnableSetMousePos + ImGuiBackendFlags_HasSetMousePos instructs dear imgui to move your mouse cursor along with navigation movements. When enabled, the NewFrame() function may alter 'io.MousePos' and set 'io.WantSetMousePos' to notify you that it wants the mouse cursor to be moved. When that happens your back-end NEEDS to move the OS or underlying mouse cursor on the next frame. Some of the binding in examples/ do that. (If you set the NavEnableSetMousePos flag but don't honor 'io.WantSetMousePos' properly, imgui will misbehave as it will see your mouse as moving back and forth!) (In a setup when you may not have easy control over the mouse cursor, e.g. uSynergy.c doesn't expose moving remote mouse cursor, you may want to set a boolean to ignore your other external mouse positions until the external source is moved again.) API BREAKING CHANGES ==================== Occasionally introducing changes that are breaking the API. We try to make the breakage minor and easy to fix. Below is a change-log of API breaking changes only. If you are using one of the functions listed, expect to have to fix some code. When you are not sure about a old symbol or function name, try using the Search/Find function of your IDE to look for comments or references in all imgui files. You can read releases logs https://github.com/ocornut/imgui/releases for more details. - 2018/05/03 (1.61) - DragInt(): The default compile-time format string has been changed from "%.0f" to "%d", as we are not using integers internally any more. If you used DragInt() with custom format strings, make sure you change them to use %d or an integer-compatible format. To honor backward-compatibility, the DragInt() code will currently parse and modify format strings to replace %*f with %d, giving time to users to upgrade their code. If you have IMGUI_DISABLE_OBSOLETE_FUNCTIONS enabled, the code will instead assert! You may run a reg-exp search on your codebase for e.g. "DragInt.*%f" to help you find them. - 2018/04/28 (1.61) - obsoleted InputFloat() functions taking an optional "int decimal_precision" in favor of an equivalent and more flexible "const char* format", consistent with other functions. Kept redirection functions (will obsolete). - 2018/04/09 (1.61) - IM_DELETE() helper function added in 1.60 doesn't clear the input _pointer_ reference, more consistent with expectation and allows passing r-value. - 2018/03/20 (1.60) - renamed io.WantMoveMouse to io.WantSetMousePos for consistency and ease of understanding (was added in 1.52, _not_ used by core and only honored by some binding ahead of merging the Nav branch). - 2018/03/12 (1.60) - removed ImGuiCol_CloseButton, ImGuiCol_CloseButtonActive, ImGuiCol_CloseButtonHovered as the closing cross uses regular button colors now. - 2018/03/08 (1.60) - changed ImFont::DisplayOffset.y to default to 0 instead of +1. Fixed rounding of Ascent/Descent to match TrueType renderer. If you were adding or subtracting to ImFont::DisplayOffset check if your fonts are correctly aligned vertically. - 2018/03/03 (1.60) - renamed ImGuiStyleVar_Count_ to ImGuiStyleVar_COUNT and ImGuiMouseCursor_Count_ to ImGuiMouseCursor_COUNT for consistency with other public enums. - 2018/02/18 (1.60) - BeginDragDropSource(): temporarily removed the optional mouse_button=0 parameter because it is not really usable in many situations at the moment. - 2018/02/16 (1.60) - obsoleted the io.RenderDrawListsFn callback, you can call your graphics engine render function after ImGui::Render(). Use ImGui::GetDrawData() to retrieve the ImDrawData* to display. - 2018/02/07 (1.60) - reorganized context handling to be more explicit, - YOU NOW NEED TO CALL ImGui::CreateContext() AT THE BEGINNING OF YOUR APP, AND CALL ImGui::DestroyContext() AT THE END. - removed Shutdown() function, as DestroyContext() serve this purpose. - you may pass a ImFontAtlas* pointer to CreateContext() to share a font atlas between contexts. Otherwise CreateContext() will create its own font atlas instance. - removed allocator parameters from CreateContext(), they are now setup with SetAllocatorFunctions(), and shared by all contexts. - removed the default global context and font atlas instance, which were confusing for users of DLL reloading and users of multiple contexts. - 2018/01/31 (1.60) - moved sample TTF files from extra_fonts/ to misc/fonts/. If you loaded files directly from the imgui repo you may need to update your paths. - 2018/01/11 (1.60) - obsoleted IsAnyWindowHovered() in favor of IsWindowHovered(ImGuiHoveredFlags_AnyWindow). Kept redirection function (will obsolete). - 2018/01/11 (1.60) - obsoleted IsAnyWindowFocused() in favor of IsWindowFocused(ImGuiFocusedFlags_AnyWindow). Kept redirection function (will obsolete). - 2018/01/03 (1.60) - renamed ImGuiSizeConstraintCallback to ImGuiSizeCallback, ImGuiSizeConstraintCallbackData to ImGuiSizeCallbackData. - 2017/12/29 (1.60) - removed CalcItemRectClosestPoint() which was weird and not really used by anyone except demo code. If you need it it's easy to replicate on your side. - 2017/12/24 (1.53) - renamed the emblematic ShowTestWindow() function to ShowDemoWindow(). Kept redirection function (will obsolete). - 2017/12/21 (1.53) - ImDrawList: renamed style.AntiAliasedShapes to style.AntiAliasedFill for consistency and as a way to explicitly break code that manipulate those flag at runtime. You can now manipulate ImDrawList::Flags - 2017/12/21 (1.53) - ImDrawList: removed 'bool anti_aliased = true' final parameter of ImDrawList::AddPolyline() and ImDrawList::AddConvexPolyFilled(). Prefer manipulating ImDrawList::Flags if you need to toggle them during the frame. - 2017/12/14 (1.53) - using the ImGuiWindowFlags_NoScrollWithMouse flag on a child window forwards the mouse wheel event to the parent window, unless either ImGuiWindowFlags_NoInputs or ImGuiWindowFlags_NoScrollbar are also set. - 2017/12/13 (1.53) - renamed GetItemsLineHeightWithSpacing() to GetFrameHeightWithSpacing(). Kept redirection function (will obsolete). - 2017/12/13 (1.53) - obsoleted IsRootWindowFocused() in favor of using IsWindowFocused(ImGuiFocusedFlags_RootWindow). Kept redirection function (will obsolete). - obsoleted IsRootWindowOrAnyChildFocused() in favor of using IsWindowFocused(ImGuiFocusedFlags_RootAndChildWindows). Kept redirection function (will obsolete). - 2017/12/12 (1.53) - renamed ImGuiTreeNodeFlags_AllowOverlapMode to ImGuiTreeNodeFlags_AllowItemOverlap. Kept redirection enum (will obsolete). - 2017/12/10 (1.53) - removed SetNextWindowContentWidth(), prefer using SetNextWindowContentSize(). Kept redirection function (will obsolete). - 2017/11/27 (1.53) - renamed ImGuiTextBuffer::append() helper to appendf(), appendv() to appendfv(). If you copied the 'Log' demo in your code, it uses appendv() so that needs to be renamed. - 2017/11/18 (1.53) - Style, Begin: removed ImGuiWindowFlags_ShowBorders window flag. Borders are now fully set up in the ImGuiStyle structure (see e.g. style.FrameBorderSize, style.WindowBorderSize). Use ImGui::ShowStyleEditor() to look them up. Please note that the style system will keep evolving (hopefully stabilizing in Q1 2018), and so custom styles will probably subtly break over time. It is recommended you use the StyleColorsClassic(), StyleColorsDark(), StyleColorsLight() functions. - 2017/11/18 (1.53) - Style: removed ImGuiCol_ComboBg in favor of combo boxes using ImGuiCol_PopupBg for consistency. - 2017/11/18 (1.53) - Style: renamed ImGuiCol_ChildWindowBg to ImGuiCol_ChildBg. - 2017/11/18 (1.53) - Style: renamed style.ChildWindowRounding to style.ChildRounding, ImGuiStyleVar_ChildWindowRounding to ImGuiStyleVar_ChildRounding. - 2017/11/02 (1.53) - obsoleted IsRootWindowOrAnyChildHovered() in favor of using IsWindowHovered(ImGuiHoveredFlags_RootAndChildWindows); - 2017/10/24 (1.52) - renamed IMGUI_DISABLE_WIN32_DEFAULT_CLIPBOARD_FUNCS/IMGUI_DISABLE_WIN32_DEFAULT_IME_FUNCS to IMGUI_DISABLE_WIN32_DEFAULT_CLIPBOARD_FUNCTIONS/IMGUI_DISABLE_WIN32_DEFAULT_IME_FUNCTIONS for consistency. - 2017/10/20 (1.52) - changed IsWindowHovered() default parameters behavior to return false if an item is active in another window (e.g. click-dragging item from another window to this window). You can use the newly introduced IsWindowHovered() flags to requests this specific behavior if you need it. - 2017/10/20 (1.52) - marked IsItemHoveredRect()/IsMouseHoveringWindow() as obsolete, in favor of using the newly introduced flags for IsItemHovered() and IsWindowHovered(). See https://github.com/ocornut/imgui/issues/1382 for details. removed the IsItemRectHovered()/IsWindowRectHovered() names introduced in 1.51 since they were merely more consistent names for the two functions we are now obsoleting. - 2017/10/17 (1.52) - marked the old 5-parameters version of Begin() as obsolete (still available). Use SetNextWindowSize()+Begin() instead! - 2017/10/11 (1.52) - renamed AlignFirstTextHeightToWidgets() to AlignTextToFramePadding(). Kept inline redirection function (will obsolete). - 2017/09/25 (1.52) - removed SetNextWindowPosCenter() because SetNextWindowPos() now has the optional pivot information to do the same and more. Kept redirection function (will obsolete). - 2017/08/25 (1.52) - io.MousePos needs to be set to ImVec2(-FLT_MAX,-FLT_MAX) when mouse is unavailable/missing. Previously ImVec2(-1,-1) was enough but we now accept negative mouse coordinates. In your binding if you need to support unavailable mouse, make sure to replace "io.MousePos = ImVec2(-1,-1)" with "io.MousePos = ImVec2(-FLT_MAX,-FLT_MAX)". - 2017/08/22 (1.51) - renamed IsItemHoveredRect() to IsItemRectHovered(). Kept inline redirection function (will obsolete). -> (1.52) use IsItemHovered(ImGuiHoveredFlags_RectOnly)! - renamed IsMouseHoveringAnyWindow() to IsAnyWindowHovered() for consistency. Kept inline redirection function (will obsolete). - renamed IsMouseHoveringWindow() to IsWindowRectHovered() for consistency. Kept inline redirection function (will obsolete). - 2017/08/20 (1.51) - renamed GetStyleColName() to GetStyleColorName() for consistency. - 2017/08/20 (1.51) - added PushStyleColor(ImGuiCol idx, ImU32 col) overload, which _might_ cause an "ambiguous call" compilation error if you are using ImColor() with implicit cast. Cast to ImU32 or ImVec4 explicily to fix. - 2017/08/15 (1.51) - marked the weird IMGUI_ONCE_UPON_A_FRAME helper macro as obsolete. prefer using the more explicit ImGuiOnceUponAFrame. - 2017/08/15 (1.51) - changed parameter order for BeginPopupContextWindow() from (const char*,int buttons,bool also_over_items) to (const char*,int buttons,bool also_over_items). Note that most calls relied on default parameters completely. - 2017/08/13 (1.51) - renamed ImGuiCol_Columns*** to ImGuiCol_Separator***. Kept redirection enums (will obsolete). - 2017/08/11 (1.51) - renamed ImGuiSetCond_*** types and flags to ImGuiCond_***. Kept redirection enums (will obsolete). - 2017/08/09 (1.51) - removed ValueColor() helpers, they are equivalent to calling Text(label) + SameLine() + ColorButton(). - 2017/08/08 (1.51) - removed ColorEditMode() and ImGuiColorEditMode in favor of ImGuiColorEditFlags and parameters to the various Color*() functions. The SetColorEditOptions() allows to initialize default but the user can still change them with right-click context menu. - changed prototype of 'ColorEdit4(const char* label, float col[4], bool show_alpha = true)' to 'ColorEdit4(const char* label, float col[4], ImGuiColorEditFlags flags = 0)', where passing flags = 0x01 is a safe no-op (hello dodgy backward compatibility!). - check and run the demo window, under "Color/Picker Widgets", to understand the various new options. - changed prototype of rarely used 'ColorButton(ImVec4 col, bool small_height = false, bool outline_border = true)' to 'ColorButton(const char* desc_id, ImVec4 col, ImGuiColorEditFlags flags = 0, ImVec2 size = ImVec2(0,0))' - 2017/07/20 (1.51) - removed IsPosHoveringAnyWindow(ImVec2), which was partly broken and misleading. ASSERT + redirect user to io.WantCaptureMouse - 2017/05/26 (1.50) - removed ImFontConfig::MergeGlyphCenterV in favor of a more multipurpose ImFontConfig::GlyphOffset. - 2017/05/01 (1.50) - renamed ImDrawList::PathFill() (rarely used directly) to ImDrawList::PathFillConvex() for clarity. - 2016/11/06 (1.50) - BeginChild(const char*) now applies the stack id to the provided label, consistently with other functions as it should always have been. It shouldn't affect you unless (extremely unlikely) you were appending multiple times to a same child from different locations of the stack id. If that's the case, generate an id with GetId() and use it instead of passing string to BeginChild(). - 2016/10/15 (1.50) - avoid 'void* user_data' parameter to io.SetClipboardTextFn/io.GetClipboardTextFn pointers. We pass io.ClipboardUserData to it. - 2016/09/25 (1.50) - style.WindowTitleAlign is now a ImVec2 (ImGuiAlign enum was removed). set to (0.5f,0.5f) for horizontal+vertical centering, (0.0f,0.0f) for upper-left, etc. - 2016/07/30 (1.50) - SameLine(x) with x>0.0f is now relative to left of column/group if any, and not always to left of window. This was sort of always the intent and hopefully breakage should be minimal. - 2016/05/12 (1.49) - title bar (using ImGuiCol_TitleBg/ImGuiCol_TitleBgActive colors) isn't rendered over a window background (ImGuiCol_WindowBg color) anymore. If your TitleBg/TitleBgActive alpha was 1.0f or you are using the default theme it will not affect you. If your TitleBg/TitleBgActive alpha was <1.0f you need to tweak your custom theme to readjust for the fact that we don't draw a WindowBg background behind the title bar. This helper function will convert an old TitleBg/TitleBgActive color into a new one with the same visual output, given the OLD color and the OLD WindowBg color. ImVec4 ConvertTitleBgCol(const ImVec4& win_bg_col, const ImVec4& title_bg_col) { float new_a = 1.0f - ((1.0f - win_bg_col.w) * (1.0f - title_bg_col.w)), k = title_bg_col.w / new_a; return ImVec4((win_bg_col.x * win_bg_col.w + title_bg_col.x) * k, (win_bg_col.y * win_bg_col.w + title_bg_col.y) * k, (win_bg_col.z * win_bg_col.w + title_bg_col.z) * k, new_a); } If this is confusing, pick the RGB value from title bar from an old screenshot and apply this as TitleBg/TitleBgActive. Or you may just create TitleBgActive from a tweaked TitleBg color. - 2016/05/07 (1.49) - removed confusing set of GetInternalState(), GetInternalStateSize(), SetInternalState() functions. Now using CreateContext(), DestroyContext(), GetCurrentContext(), SetCurrentContext(). - 2016/05/02 (1.49) - renamed SetNextTreeNodeOpened() to SetNextTreeNodeOpen(), no redirection. - 2016/05/01 (1.49) - obsoleted old signature of CollapsingHeader(const char* label, const char* str_id = NULL, bool display_frame = true, bool default_open = false) as extra parameters were badly designed and rarely used. You can replace the "default_open = true" flag in new API with CollapsingHeader(label, ImGuiTreeNodeFlags_DefaultOpen). - 2016/04/26 (1.49) - changed ImDrawList::PushClipRect(ImVec4 rect) to ImDraw::PushClipRect(Imvec2 min,ImVec2 max,bool intersect_with_current_clip_rect=false). Note that higher-level ImGui::PushClipRect() is preferable because it will clip at logic/widget level, whereas ImDrawList::PushClipRect() only affect your renderer. - 2016/04/03 (1.48) - removed style.WindowFillAlphaDefault setting which was redundant. Bake default BG alpha inside style.Colors[ImGuiCol_WindowBg] and all other Bg color values. (ref github issue #337). - 2016/04/03 (1.48) - renamed ImGuiCol_TooltipBg to ImGuiCol_PopupBg, used by popups/menus and tooltips. popups/menus were previously using ImGuiCol_WindowBg. (ref github issue #337) - 2016/03/21 (1.48) - renamed GetWindowFont() to GetFont(), GetWindowFontSize() to GetFontSize(). Kept inline redirection function (will obsolete). - 2016/03/02 (1.48) - InputText() completion/history/always callbacks: if you modify the text buffer manually (without using DeleteChars()/InsertChars() helper) you need to maintain the BufTextLen field. added an assert. - 2016/01/23 (1.48) - fixed not honoring exact width passed to PushItemWidth(), previously it would add extra FramePadding.x*2 over that width. if you had manual pixel-perfect alignment in place it might affect you. - 2015/12/27 (1.48) - fixed ImDrawList::AddRect() which used to render a rectangle 1 px too large on each axis. - 2015/12/04 (1.47) - renamed Color() helpers to ValueColor() - dangerously named, rarely used and probably to be made obsolete. - 2015/08/29 (1.45) - with the addition of horizontal scrollbar we made various fixes to inconsistencies with dealing with cursor position. GetCursorPos()/SetCursorPos() functions now include the scrolled amount. It shouldn't affect the majority of users, but take note that SetCursorPosX(100.0f) puts you at +100 from the starting x position which may include scrolling, not at +100 from the window left side. GetContentRegionMax()/GetWindowContentRegionMin()/GetWindowContentRegionMax() functions allow include the scrolled amount. Typically those were used in cases where no scrolling would happen so it may not be a problem, but watch out! - 2015/08/29 (1.45) - renamed style.ScrollbarWidth to style.ScrollbarSize - 2015/08/05 (1.44) - split imgui.cpp into extra files: imgui_demo.cpp imgui_draw.cpp imgui_internal.h that you need to add to your project. - 2015/07/18 (1.44) - fixed angles in ImDrawList::PathArcTo(), PathArcToFast() (introduced in 1.43) being off by an extra PI for no justifiable reason - 2015/07/14 (1.43) - add new ImFontAtlas::AddFont() API. For the old AddFont***, moved the 'font_no' parameter of ImFontAtlas::AddFont** functions to the ImFontConfig structure. you need to render your textured triangles with bilinear filtering to benefit from sub-pixel positioning of text. - 2015/07/08 (1.43) - switched rendering data to use indexed rendering. this is saving a fair amount of CPU/GPU and enables us to get anti-aliasing for a marginal cost. this necessary change will break your rendering function! the fix should be very easy. sorry for that :( - if you are using a vanilla copy of one of the imgui_impl_XXXX.cpp provided in the example, you just need to update your copy and you can ignore the rest. - the signature of the io.RenderDrawListsFn handler has changed! old: ImGui_XXXX_RenderDrawLists(ImDrawList** const cmd_lists, int cmd_lists_count) new: ImGui_XXXX_RenderDrawLists(ImDrawData* draw_data). argument: 'cmd_lists' becomes 'draw_data->CmdLists', 'cmd_lists_count' becomes 'draw_data->CmdListsCount' ImDrawList: 'commands' becomes 'CmdBuffer', 'vtx_buffer' becomes 'VtxBuffer', 'IdxBuffer' is new. ImDrawCmd: 'vtx_count' becomes 'ElemCount', 'clip_rect' becomes 'ClipRect', 'user_callback' becomes 'UserCallback', 'texture_id' becomes 'TextureId'. - each ImDrawList now contains both a vertex buffer and an index buffer. For each command, render ElemCount/3 triangles using indices from the index buffer. - if you REALLY cannot render indexed primitives, you can call the draw_data->DeIndexAllBuffers() method to de-index the buffers. This is slow and a waste of CPU/GPU. Prefer using indexed rendering! - refer to code in the examples/ folder or ask on the GitHub if you are unsure of how to upgrade. please upgrade! - 2015/07/10 (1.43) - changed SameLine() parameters from int to float. - 2015/07/02 (1.42) - renamed SetScrollPosHere() to SetScrollFromCursorPos(). Kept inline redirection function (will obsolete). - 2015/07/02 (1.42) - renamed GetScrollPosY() to GetScrollY(). Necessary to reduce confusion along with other scrolling functions, because positions (e.g. cursor position) are not equivalent to scrolling amount. - 2015/06/14 (1.41) - changed ImageButton() default bg_col parameter from (0,0,0,1) (black) to (0,0,0,0) (transparent) - makes a difference when texture have transparence - 2015/06/14 (1.41) - changed Selectable() API from (label, selected, size) to (label, selected, flags, size). Size override should have been rarely be used. Sorry! - 2015/05/31 (1.40) - renamed GetWindowCollapsed() to IsWindowCollapsed() for consistency. Kept inline redirection function (will obsolete). - 2015/05/31 (1.40) - renamed IsRectClipped() to IsRectVisible() for consistency. Note that return value is opposite! Kept inline redirection function (will obsolete). - 2015/05/27 (1.40) - removed the third 'repeat_if_held' parameter from Button() - sorry! it was rarely used and inconsistent. Use PushButtonRepeat(true) / PopButtonRepeat() to enable repeat on desired buttons. - 2015/05/11 (1.40) - changed BeginPopup() API, takes a string identifier instead of a bool. ImGui needs to manage the open/closed state of popups. Call OpenPopup() to actually set the "open" state of a popup. BeginPopup() returns true if the popup is opened. - 2015/05/03 (1.40) - removed style.AutoFitPadding, using style.WindowPadding makes more sense (the default values were already the same). - 2015/04/13 (1.38) - renamed IsClipped() to IsRectClipped(). Kept inline redirection function until 1.50. - 2015/04/09 (1.38) - renamed ImDrawList::AddArc() to ImDrawList::AddArcFast() for compatibility with future API - 2015/04/03 (1.38) - removed ImGuiCol_CheckHovered, ImGuiCol_CheckActive, replaced with the more general ImGuiCol_FrameBgHovered, ImGuiCol_FrameBgActive. - 2014/04/03 (1.38) - removed support for passing -FLT_MAX..+FLT_MAX as the range for a SliderFloat(). Use DragFloat() or Inputfloat() instead. - 2015/03/17 (1.36) - renamed GetItemBoxMin()/GetItemBoxMax()/IsMouseHoveringBox() to GetItemRectMin()/GetItemRectMax()/IsMouseHoveringRect(). Kept inline redirection function until 1.50. - 2015/03/15 (1.36) - renamed style.TreeNodeSpacing to style.IndentSpacing, ImGuiStyleVar_TreeNodeSpacing to ImGuiStyleVar_IndentSpacing - 2015/03/13 (1.36) - renamed GetWindowIsFocused() to IsWindowFocused(). Kept inline redirection function until 1.50. - 2015/03/08 (1.35) - renamed style.ScrollBarWidth to style.ScrollbarWidth (casing) - 2015/02/27 (1.34) - renamed OpenNextNode(bool) to SetNextTreeNodeOpened(bool, ImGuiSetCond). Kept inline redirection function until 1.50. - 2015/02/27 (1.34) - renamed ImGuiSetCondition_*** to ImGuiSetCond_***, and _FirstUseThisSession becomes _Once. - 2015/02/11 (1.32) - changed text input callback ImGuiTextEditCallback return type from void-->int. reserved for future use, return 0 for now. - 2015/02/10 (1.32) - renamed GetItemWidth() to CalcItemWidth() to clarify its evolving behavior - 2015/02/08 (1.31) - renamed GetTextLineSpacing() to GetTextLineHeightWithSpacing() - 2015/02/01 (1.31) - removed IO.MemReallocFn (unused) - 2015/01/19 (1.30) - renamed ImGuiStorage::GetIntPtr()/GetFloatPtr() to GetIntRef()/GetIntRef() because Ptr was conflicting with actual pointer storage functions. - 2015/01/11 (1.30) - big font/image API change! now loads TTF file. allow for multiple fonts. no need for a PNG loader. (1.30) - removed GetDefaultFontData(). uses io.Fonts->GetTextureData*() API to retrieve uncompressed pixels. font init: const void* png_data; unsigned int png_size; ImGui::GetDefaultFontData(NULL, NULL, &png_data, &png_size); <..Upload texture to GPU..> became: unsigned char* pixels; int width, height; io.Fonts->GetTexDataAsRGBA32(&pixels, &width, &height); <..Upload texture to GPU>; io.Fonts->TexId = YourTextureIdentifier; you now more flexibility to load multiple TTF fonts and manage the texture buffer for internal needs. it is now recommended that you sample the font texture with bilinear interpolation. (1.30) - added texture identifier in ImDrawCmd passed to your render function (we can now render images). make sure to set io.Fonts->TexID. (1.30) - removed IO.PixelCenterOffset (unnecessary, can be handled in user projection matrix) (1.30) - removed ImGui::IsItemFocused() in favor of ImGui::IsItemActive() which handles all widgets - 2014/12/10 (1.18) - removed SetNewWindowDefaultPos() in favor of new generic API SetNextWindowPos(pos, ImGuiSetCondition_FirstUseEver) - 2014/11/28 (1.17) - moved IO.Font*** options to inside the IO.Font-> structure (FontYOffset, FontTexUvForWhite, FontBaseScale, FontFallbackGlyph) - 2014/11/26 (1.17) - reworked syntax of IMGUI_ONCE_UPON_A_FRAME helper macro to increase compiler compatibility - 2014/11/07 (1.15) - renamed IsHovered() to IsItemHovered() - 2014/10/02 (1.14) - renamed IMGUI_INCLUDE_IMGUI_USER_CPP to IMGUI_INCLUDE_IMGUI_USER_INL and imgui_user.cpp to imgui_user.inl (more IDE friendly) - 2014/09/25 (1.13) - removed 'text_end' parameter from IO.SetClipboardTextFn (the string is now always zero-terminated for simplicity) - 2014/09/24 (1.12) - renamed SetFontScale() to SetWindowFontScale() - 2014/09/24 (1.12) - moved IM_MALLOC/IM_REALLOC/IM_FREE preprocessor defines to IO.MemAllocFn/IO.MemReallocFn/IO.MemFreeFn - 2014/08/30 (1.09) - removed IO.FontHeight (now computed automatically) - 2014/08/30 (1.09) - moved IMGUI_FONT_TEX_UV_FOR_WHITE preprocessor define to IO.FontTexUvForWhite - 2014/08/28 (1.09) - changed the behavior of IO.PixelCenterOffset following various rendering fixes ISSUES & TODO-LIST ================== See TODO.txt FREQUENTLY ASKED QUESTIONS (FAQ), TIPS ====================================== Q: How can I tell whether to dispatch mouse/keyboard to imgui or to my application? A: You can read the 'io.WantCaptureMouse', 'io.WantCaptureKeyboard' and 'io.WantTextInput' flags from the ImGuiIO structure. - When 'io.WantCaptureMouse' is set, imgui wants to use your mouse state, and you may want to discard/hide the inputs from the rest of your application. - When 'io.WantCaptureKeyboard' is set, imgui wants to use your keyboard state, and you may want to discard/hide the inputs from the rest of your application. - When 'io.WantTextInput' is set to may want to notify your OS to popup an on-screen keyboard, if available (e.g. on a mobile phone, or console OS). Note: you should always pass your mouse/keyboard inputs to imgui, even when the io.WantCaptureXXX flag are set false. This is because imgui needs to detect that you clicked in the void to unfocus its windows. Note: The 'io.WantCaptureMouse' is more accurate that any attempt to "check if the mouse is hovering a window" (don't do that!). It handle mouse dragging correctly (both dragging that started over your application or over an imgui window) and handle e.g. modal windows blocking inputs. Those flags are updated by ImGui::NewFrame(). Preferably read the flags after calling NewFrame() if you can afford it, but reading them before is also perfectly fine, as the bool toggle fairly rarely. If you have on a touch device, you might find use for an early call to NewFrameUpdateHoveredWindowAndCaptureFlags(). Note: Text input widget releases focus on "Return KeyDown", so the subsequent "Return KeyUp" event that your application receive will typically have 'io.WantCaptureKeyboard=false'. Depending on your application logic it may or not be inconvenient. You might want to track which key-downs were targeted for Dear ImGui, e.g. with an array of bool, and filter out the corresponding key-ups.) Q: How can I display an image? What is ImTextureID, how does it works? A: ImTextureID is a void* used to pass renderer-agnostic texture references around until it hits your render function. Dear ImGui knows nothing about what those bits represent, it just passes them around. It is up to you to decide what you want the void* to carry! It could be an identifier to your OpenGL texture (cast GLuint to void*), a pointer to your custom engine material (cast MyMaterial* to void*), etc. At the end of the chain, your renderer takes this void* to cast it back into whatever it needs to select a current texture to render. Refer to examples applications, where each renderer (in a imgui_impl_xxxx.cpp file) is treating ImTextureID as a different thing. (C++ tip: OpenGL uses integers to identify textures. You can safely store an integer into a void*, just cast it to void*, don't take it's address!) To display a custom image/texture within an ImGui window, you may use ImGui::Image(), ImGui::ImageButton(), ImDrawList::AddImage() functions. Dear ImGui will generate the geometry and draw calls using the ImTextureID that you passed and which your renderer can use. You may call ImGui::ShowMetricsWindow() to explore active draw lists and visualize/understand how the draw data is generated. It is your responsibility to get textures uploaded to your GPU. Q: How can I have multiple widgets with the same label or without a label? A: A primer on labels and the ID Stack... - Elements that are typically not clickable, such as Text() items don't need an ID. - Interactive widgets require state to be carried over multiple frames (most typically Dear ImGui often needs to remember what is the "active" widget). To do so they need a unique ID. Unique ID are typically derived from a string label, an integer index or a pointer. Button("OK"); // Label = "OK", ID = top of id stack + hash of "OK" Button("Cancel"); // Label = "Cancel", ID = top of id stack + hash of "Cancel" - ID are uniquely scoped within windows, tree nodes, etc. which all pushes to the ID stack. Having two buttons labeled "OK" in different windows or different tree locations is fine. - If you have a same ID twice in the same location, you'll have a conflict: Button("OK"); Button("OK"); // ID collision! Interacting with either button will trigger the first one. Fear not! this is easy to solve and there are many ways to solve it! - Solving ID conflict in a simple/local context: When passing a label you can optionally specify extra ID information within string itself. Use "##" to pass a complement to the ID that won't be visible to the end-user. This helps solving the simple collision cases when you know e.g. at compilation time which items are going to be created: Button("Play"); // Label = "Play", ID = top of id stack + hash of "Play" Button("Play##foo1"); // Label = "Play", ID = top of id stack + hash of "Play##foo1" (different from above) Button("Play##foo2"); // Label = "Play", ID = top of id stack + hash of "Play##foo2" (different from above) - If you want to completely hide the label, but still need an ID: Checkbox("##On", &b); // Label = "", ID = top of id stack + hash of "##On" (no label!) - Occasionally/rarely you might want change a label while preserving a constant ID. This allows you to animate labels. For example you may want to include varying information in a window title bar, but windows are uniquely identified by their ID. Use "###" to pass a label that isn't part of ID: Button("Hello###ID"; // Label = "Hello", ID = top of id stack + hash of "ID" Button("World###ID"; // Label = "World", ID = top of id stack + hash of "ID" (same as above) sprintf(buf, "My game (%f FPS)###MyGame", fps); Begin(buf); // Variable label, ID = hash of "MyGame" - Solving ID conflict in a more general manner: Use PushID() / PopID() to create scopes and manipulate the ID stack, as to avoid ID conflicts within the same window. This is the most convenient way of distinguishing ID when iterating and creating many UI elements programmatically. You can push a pointer, a string or an integer value into the ID stack. Remember that ID are formed from the concatenation of _everything_ in the ID stack! for (int i = 0; i < 100; i++) { PushID(i); Button("Click"); // Label = "Click", ID = top of id stack + hash of integer + hash of "Click" PopID(); } for (int i = 0; i < 100; i++) { MyObject* obj = Objects[i]; PushID(obj); Button("Click"); // Label = "Click", ID = top of id stack + hash of pointer + hash of "Click" PopID(); } for (int i = 0; i < 100; i++) { MyObject* obj = Objects[i]; PushID(obj->Name); Button("Click"); // Label = "Click", ID = top of id stack + hash of string + hash of "Click" PopID(); } - More example showing that you can stack multiple prefixes into the ID stack: Button("Click"); // Label = "Click", ID = top of id stack + hash of "Click" PushID("node"); Button("Click"); // Label = "Click", ID = top of id stack + hash of "node" + hash of "Click" PushID(my_ptr); Button("Click"); // Label = "Click", ID = top of id stack + hash of "node" + hash of ptr + hash of "Click" PopID(); PopID(); - Tree nodes implicitly creates a scope for you by calling PushID(). Button("Click"); // Label = "Click", ID = top of id stack + hash of "Click" if (TreeNode("node")) { Button("Click"); // Label = "Click", ID = top of id stack + hash of "node" + hash of "Click" TreePop(); } - When working with trees, ID are used to preserve the open/close state of each tree node. Depending on your use cases you may want to use strings, indices or pointers as ID. e.g. when following a single pointer that may change over time, using a static string as ID will preserve your node open/closed state when the targeted object change. e.g. when displaying a list of objects, using indices or pointers as ID will preserve the node open/closed state differently. See what makes more sense in your situation! Q: How can I load a different font than the default? A: Use the font atlas to load the TTF/OTF file you want: ImGuiIO& io = ImGui::GetIO(); io.Fonts->AddFontFromFileTTF("myfontfile.ttf", size_in_pixels); io.Fonts->GetTexDataAsRGBA32() or GetTexDataAsAlpha8() (default is ProggyClean.ttf, rendered at size 13, embedded in dear imgui's source code) New programmers: remember that in C/C++ and most programming languages if you want to use a backslash \ within a string literal, you need to write it double backslash "\\": io.Fonts->AddFontFromFileTTF("MyDataFolder\MyFontFile.ttf", size_in_pixels); // WRONG (you are escape the M here!) io.Fonts->AddFontFromFileTTF("MyDataFolder\\MyFontFile.ttf", size_in_pixels); // CORRECT io.Fonts->AddFontFromFileTTF("MyDataFolder/MyFontFile.ttf", size_in_pixels); // ALSO CORRECT Q: How can I easily use icons in my application? A: The most convenient and practical way is to merge an icon font such as FontAwesome inside you main font. Then you can refer to icons within your strings. Read 'How can I load multiple fonts?' and the file 'misc/fonts/README.txt' for instructions and useful header files. Q: How can I load multiple fonts? A: Use the font atlas to pack them into a single texture: (Read misc/fonts/README.txt and the code in ImFontAtlas for more details.) ImGuiIO& io = ImGui::GetIO(); ImFont* font0 = io.Fonts->AddFontDefault(); ImFont* font1 = io.Fonts->AddFontFromFileTTF("myfontfile.ttf", size_in_pixels); ImFont* font2 = io.Fonts->AddFontFromFileTTF("myfontfile2.ttf", size_in_pixels); io.Fonts->GetTexDataAsRGBA32() or GetTexDataAsAlpha8() // the first loaded font gets used by default // use ImGui::PushFont()/ImGui::PopFont() to change the font at runtime // Options ImFontConfig config; config.OversampleH = 3; config.OversampleV = 1; config.GlyphOffset.y -= 2.0f; // Move everything by 2 pixels up config.GlyphExtraSpacing.x = 1.0f; // Increase spacing between characters io.Fonts->LoadFromFileTTF("myfontfile.ttf", size_pixels, &config); // Combine multiple fonts into one (e.g. for icon fonts) ImWchar ranges[] = { 0xf000, 0xf3ff, 0 }; ImFontConfig config; config.MergeMode = true; io.Fonts->AddFontDefault(); io.Fonts->LoadFromFileTTF("fontawesome-webfont.ttf", 16.0f, &config, ranges); // Merge icon font io.Fonts->LoadFromFileTTF("myfontfile.ttf", size_pixels, NULL, &config, io.Fonts->GetGlyphRangesJapanese()); // Merge japanese glyphs