<br>
# glinkfix
<br>
<img src="https://lh3.googleusercontent.com/d/1H04KVAA3ohH_dLXIrC0bXuJXDn3VutKc"
alt="Dinobox logo" width="120"/>
## Google Drive Link Fixer
## Notes (please read)
1. It's turning into an arms race. Google keeps changing how links are
handled on their servers, which often breaks tools like glinkfix.
Direct downloading and embedding G-Drive links is definitely an
unsupported "off the books" feature as far as Google is concerned. As
of Jan 2024, Google made a significant change, which definitely broke
some links created with this tool. This update (Apr 2024) works, *for
now*, but if Google changes again, things may break.
2. Viewing links that point to animated gifs may just show up as static
images.
3. In the v2 update, in addition to displaying the fixed link on the
screen, glinkfix will also attempt to copy the fixed link to the
clipboard. Copying to the clipboard only works for Desktop-based
operating systems (not Server installs). Even without automatic
copying, link fixing will still work and the results will be
displayed on the screen, regardless of where you run it (Server or
Desktop). glinkfix uses the [pyperclip][def9] library, and automatic
copying to the clipboard should work seamlessly on Windows/Mac. If
you're running Linux and links are not automatically copied to the
clipboard, [refer to this note][def8] from the pyperclip developer.
## To Developers
If you're just using glinkfix, then carry on!
If you're a developer looking to fork this repository and modify
glinkfix, there are two important considerations:
1. glinkfix requires [poetry][def] for dependency management. Poetry is
well behaved and if you're a Python developer you should check it
out. It installs itself in a virtual environment, uninstalls cleanly
and easily, and doesn't require `sudo` for installation. Visit the
[poetry site][def] and install it using the instructions for your
operating system.
*Note: When you install poetry, pay careful attention to the message
printed by the poetry installer. It provides details on how to modify
`$PATH` to access the poetry runtime.*
2. I've included a file called `global-gitignore.txt` which is a copy of
the `.gitignore` I placed in my home directory and configured
globally for all my development projects. The `global-gitignore.txt`
file reflects my development setup (for example using tools like
vscode), but yours may be different. Just cherry-pick any necessary
elements from `global-gitignore.txt` for your own use.
*Details on gitignore files are available on [GitHub][def2].*
## Installation
The preferred way to install glinkfix is with [pipx][def3]:
```shell
pipx install glinkfix
```
Alternatively, you can create a separate virtual environment and install
it the traditional way:
```shell
pip3 install glinkfix
```
If you just need a quick one-time link fix, and don't want to commit to
a full installation, use:
```shell
pipx run glinkfix -h
```
and follow the directions to run it again with the option you want.
## Purpose / Usage
When you share files with Google Drive, the sharing link you get is only
good for accessing the content through a web browser. If you want to use
a Google Drive sharing link to embed an image in a document (e.g. in a
markdown or html file), or you want to directly download a file
pointed-to by a Google Drive sharing link using something like `curl` or
`wget` in linux, the link needs to be adjusted ("fixed") for these
purposes.
It's not especially hard to repackage the link, but it's a pain. You
have to copy the link to a text editor, carve it up manually, and
reassemble it. If you've got a lot of links to deal with it starts to
get very tedious. This tool is designed to remove the tedium.
*Note: The images below are actually hosted on Google Drive and the
"fixed" links are embedded into this README file.*
---
Start by getting a sharing link to a file on Google Drive. Make sure
it's set up for public access (*Anyone with the link*):
<img src="https://lh3.googleusercontent.com/d/1aHqCi_R6S9T9OI8kYLj-bH-Rd1eEgiWd"
alt="Getting Link" width="450"/>
---
<img src="https://lh3.googleusercontent.com/d/1DM7C91o8K32B95YkVPUv9rVga6lJdYzA"
alt="Getting Link" width="450"/>
Now run `glinkfix` and paste the link into the terminal. Copy the
"fixed" version and use it as required.
---
To display the help menu, run: `glinkfix -h`
```text
usage: glinkfix [-h] [-d]
This program takes a Google Drive sharing link for a file and repackages
it into a link that can be downloaded directly (e.g. using curl) or
embedded in a document to be viewed (e.g. an image in a markdown
document). Note: there is a size limit of 40MB for a single file when
using Google Drive links in this manner.
optional arguments:
-h, --help show this help message and exit
-d, --download The default behavior for glinkfix is to repackage a
Google Drive link to make it suitable for embedding in
a website. Use this option if you want to repackage
Google Drive link for direct downloading (e.g.
downloading using curl).
```
## Usage Notes
* There is a 40MB size limit for a single file when using Google Drive
sharing links directly for viewing or downloading. Individual files
larger than 40MB will not render/download properly. This limit is a
function of how Google Drive works and is not related to `glinkfix`.
* When creating a download link for use with `curl` make sure to use
`curl`'s `-L` option to allow for redirects.
* `glinkfix` supports links that use Google's [resource key][def6]
security feature.
## Version History
View releases on the [glinkfix git repository][def7]
[def]: https://python-poetry.org/
[def2]: https://docs.github.com/en/get-started/getting-started-with-git/ignoring-files
[def3]: https://pipx.pypa.io/stable/
[def6]: https://support.google.com/a/answer/10685032
[def7]: https://github.com/geozeke/glinkfix
[def8]: https://pyperclip.readthedocs.io/en/latest/index.html#not-implemented-error
[def9]: https://pypi.org/project/pyperclip/
Raw data
{
"_id": null,
"home_page": "https://github.com/geozeke/glinkfix",
"name": "glinkfix",
"maintainer": "Peter Nardi",
"docs_url": null,
"requires_python": "<4.0,>=3.8",
"maintainer_email": "pete@nardi.com",
"keywords": "glinkfix, google, drive, link, curl, markdown, embed, image, download",
"author": "Peter Nardi",
"author_email": "pete@nardi.com",
"download_url": "https://files.pythonhosted.org/packages/d6/f5/30c03858b829076f0f8c251c1c54401939cfb3c597e5ec39d94548d8cef3/glinkfix-2.0.0.tar.gz",
"platform": null,
"description": "\n\n\n\n\n\n\n\n\n<br>\n\n# glinkfix\n\n<br>\n\n<img src=\"https://lh3.googleusercontent.com/d/1H04KVAA3ohH_dLXIrC0bXuJXDn3VutKc\"\nalt=\"Dinobox logo\" width=\"120\"/>\n\n## Google Drive Link Fixer\n\n## Notes (please read)\n\n1. It's turning into an arms race. Google keeps changing how links are\n handled on their servers, which often breaks tools like glinkfix.\n Direct downloading and embedding G-Drive links is definitely an\n unsupported \"off the books\" feature as far as Google is concerned. As\n of Jan 2024, Google made a significant change, which definitely broke\n some links created with this tool. This update (Apr 2024) works, *for\n now*, but if Google changes again, things may break.\n\n2. Viewing links that point to animated gifs may just show up as static\n images.\n\n3. In the v2 update, in addition to displaying the fixed link on the\n screen, glinkfix will also attempt to copy the fixed link to the\n clipboard. Copying to the clipboard only works for Desktop-based\n operating systems (not Server installs). Even without automatic\n copying, link fixing will still work and the results will be\n displayed on the screen, regardless of where you run it (Server or\n Desktop). glinkfix uses the [pyperclip][def9] library, and automatic\n copying to the clipboard should work seamlessly on Windows/Mac. If\n you're running Linux and links are not automatically copied to the\n clipboard, [refer to this note][def8] from the pyperclip developer.\n\n## To Developers\n\nIf you're just using glinkfix, then carry on!\n\nIf you're a developer looking to fork this repository and modify\nglinkfix, there are two important considerations:\n\n1. glinkfix requires [poetry][def] for dependency management. Poetry is\n well behaved and if you're a Python developer you should check it\n out. It installs itself in a virtual environment, uninstalls cleanly\n and easily, and doesn't require `sudo` for installation. Visit the\n [poetry site][def] and install it using the instructions for your\n operating system.\n\n *Note: When you install poetry, pay careful attention to the message\n printed by the poetry installer. It provides details on how to modify\n `$PATH` to access the poetry runtime.*\n\n2. I've included a file called `global-gitignore.txt` which is a copy of\n the `.gitignore` I placed in my home directory and configured\n globally for all my development projects. The `global-gitignore.txt`\n file reflects my development setup (for example using tools like\n vscode), but yours may be different. Just cherry-pick any necessary\n elements from `global-gitignore.txt` for your own use.\n\n *Details on gitignore files are available on [GitHub][def2].*\n\n## Installation\n\nThe preferred way to install glinkfix is with [pipx][def3]:\n\n```shell\npipx install glinkfix\n```\n\nAlternatively, you can create a separate virtual environment and install\nit the traditional way:\n\n```shell\npip3 install glinkfix\n```\n\nIf you just need a quick one-time link fix, and don't want to commit to\na full installation, use:\n\n```shell\npipx run glinkfix -h\n```\n\nand follow the directions to run it again with the option you want.\n\n## Purpose / Usage\n\nWhen you share files with Google Drive, the sharing link you get is only\ngood for accessing the content through a web browser. If you want to use\na Google Drive sharing link to embed an image in a document (e.g. in a\nmarkdown or html file), or you want to directly download a file\npointed-to by a Google Drive sharing link using something like `curl` or\n`wget` in linux, the link needs to be adjusted (\"fixed\") for these\npurposes.\n\nIt's not especially hard to repackage the link, but it's a pain. You\nhave to copy the link to a text editor, carve it up manually, and\nreassemble it. If you've got a lot of links to deal with it starts to\nget very tedious. This tool is designed to remove the tedium.\n\n*Note: The images below are actually hosted on Google Drive and the\n\"fixed\" links are embedded into this README file.*\n\n---\n\nStart by getting a sharing link to a file on Google Drive. Make sure\nit's set up for public access (*Anyone with the link*):\n\n<img src=\"https://lh3.googleusercontent.com/d/1aHqCi_R6S9T9OI8kYLj-bH-Rd1eEgiWd\"\nalt=\"Getting Link\" width=\"450\"/>\n\n---\n\n<img src=\"https://lh3.googleusercontent.com/d/1DM7C91o8K32B95YkVPUv9rVga6lJdYzA\"\nalt=\"Getting Link\" width=\"450\"/>\n\nNow run `glinkfix` and paste the link into the terminal. Copy the\n\"fixed\" version and use it as required.\n\n---\n\nTo display the help menu, run: `glinkfix -h`\n\n```text\nusage: glinkfix [-h] [-d]\n\nThis program takes a Google Drive sharing link for a file and repackages\nit into a link that can be downloaded directly (e.g. using curl) or\nembedded in a document to be viewed (e.g. an image in a markdown\ndocument). Note: there is a size limit of 40MB for a single file when\nusing Google Drive links in this manner.\n\noptional arguments:\n -h, --help show this help message and exit\n -d, --download The default behavior for glinkfix is to repackage a\n Google Drive link to make it suitable for embedding in\n a website. Use this option if you want to repackage\n Google Drive link for direct downloading (e.g.\n downloading using curl).\n```\n\n## Usage Notes\n\n* There is a 40MB size limit for a single file when using Google Drive\n sharing links directly for viewing or downloading. Individual files\n larger than 40MB will not render/download properly. This limit is a\n function of how Google Drive works and is not related to `glinkfix`.\n* When creating a download link for use with `curl` make sure to use\n `curl`'s `-L` option to allow for redirects.\n* `glinkfix` supports links that use Google's [resource key][def6]\n security feature.\n\n## Version History\n\nView releases on the [glinkfix git repository][def7]\n\n[def]: https://python-poetry.org/\n[def2]: https://docs.github.com/en/get-started/getting-started-with-git/ignoring-files\n[def3]: https://pipx.pypa.io/stable/\n[def6]: https://support.google.com/a/answer/10685032\n[def7]: https://github.com/geozeke/glinkfix\n[def8]: https://pyperclip.readthedocs.io/en/latest/index.html#not-implemented-error\n[def9]: https://pypi.org/project/pyperclip/\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Google Drive Link Fixer",
"version": "2.0.0",
"project_urls": {
"Bug Tracker": "https://github.com/geozeke/glinkfix/issues",
"Homepage": "https://github.com/geozeke/glinkfix",
"Source Code": "https://github.com/geozeke/glinkfix"
},
"split_keywords": [
"glinkfix",
" google",
" drive",
" link",
" curl",
" markdown",
" embed",
" image",
" download"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e7b31d96ee69db578dc849d3e687e58328b4cf2a029773b2abac1c27175c0c92",
"md5": "f5435a01e929f183e0703aba59b161ef",
"sha256": "077ca72a538f687d48b4eb65e8488ba2863769207f3aa4d56aed3f41244fd685"
},
"downloads": -1,
"filename": "glinkfix-2.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f5435a01e929f183e0703aba59b161ef",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.8",
"size": 7313,
"upload_time": "2024-04-23T15:49:12",
"upload_time_iso_8601": "2024-04-23T15:49:12.265153Z",
"url": "https://files.pythonhosted.org/packages/e7/b3/1d96ee69db578dc849d3e687e58328b4cf2a029773b2abac1c27175c0c92/glinkfix-2.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d6f530c03858b829076f0f8c251c1c54401939cfb3c597e5ec39d94548d8cef3",
"md5": "bed8fabba9579259b97e7d1e350df983",
"sha256": "c35f3f1943b26b66b53199a1aad4e8f33dbce2b1220a459126bec5f6e7cce8e9"
},
"downloads": -1,
"filename": "glinkfix-2.0.0.tar.gz",
"has_sig": false,
"md5_digest": "bed8fabba9579259b97e7d1e350df983",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.8",
"size": 6285,
"upload_time": "2024-04-23T15:49:14",
"upload_time_iso_8601": "2024-04-23T15:49:14.017379Z",
"url": "https://files.pythonhosted.org/packages/d6/f5/30c03858b829076f0f8c251c1c54401939cfb3c597e5ec39d94548d8cef3/glinkfix-2.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-23 15:49:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "geozeke",
"github_project": "glinkfix",
"travis_ci": false,
"coveralls": true,
"github_actions": false,
"lcname": "glinkfix"
}
JSON
