Small, dependency-free, fast Python package for removing tracking fields from URLs.
Project description
Unalix is a library written in Python, it follows the same specification used by the ClearURLs addon for removing tracking fields from URLs.
Installation
Install using pip
:
python3 -m pip install --force-reinstall \
--disable-pip-version-check \
--upgrade \
'unalix'
The version from git might be broken sometimes, but you can also install from it:
python3 -m pip install --force-reinstall \
--disable-pip-version-check \
--upgrade \
'https://codeload.github.com/AmanoTeam/Unalix/tar.gz/refs/heads/master'
Note: Unalix requires Python 3.6 or higher.
Usage:
Removing tracking fields:
import unalix
url = "https://deezer.com/track/891177062?utm_source=deezer"
result = unalix.clear_url(url)
print(result)
Unshort shortened URL:
import unalix
url = "https://bitly.is/Pricing-Pop-Up"
result = unalix.unshort_url(url)
print(result)
Output from both examples:
https://deezer.com/track/891177062
https://bitly.com/pages/pricing
Tip: unshort_url()
will strip tracking fields from any URL before following a redirect, so you don't need to manually call clear_url()
for it.
Contributing
If you have discovered a bug in this library and know how to fix it, fork this repository and open a Pull Request.
If you found a URL that was not fully cleaned by Unalix (e.g. some tracking fields still remains), report them here or in the ClearURLs rules repository. We use the list of regex rules maintained by the ClearURLs maintainers, but we also have our own list.
Third party software
Unalix includes some third party software in its codebase. See them below:
-
ClearURLs
- Author: Kevin Röbert
- Repository: ClearURLs/Rules
- License: GNU Lesser General Public License v3.0
-
Requests
- Author: Kenneth Reitz
- Repository: psf/requests
- License: Apache v2.0
-
Pyrogram
- Author: Dan
- Repository: pyrogram/pyrogram
- License: LGPL-3.0
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.