https://github.com/alexanderwillner/unc2url

https://github.com/alexanderwillner/unc2url

Last synced: 10 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/alexanderwillner/unc2url
• Owner: AlexanderWillner
• Created: 2021-06-10T23:33:21.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2021-07-05T22:39:35.000Z (over 4 years ago)
• Last Synced: 2025-02-05T23:28:11.329Z (11 months ago)
• Language: Python
• Size: 206 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# UNC2URL [![Build Status](https://github.com/alexanderwillner/unc2url/workflows/Build-Test/badge.svg)](https://github.com/alexanderwillner/unc2url/actions)[![Coverage Status](https://codecov.io/gh/alexanderwillner/unc2url/branch/master/graph/badge.svg?token=dJbdYWeg7d)](https://codecov.io/gh/alexanderwillner/unc2url)[![Scrutinizer Code Quality](https://img.shields.io/scrutinizer/quality/g/alexanderwillner/unc2url)](https://scrutinizer-ci.com/g/alexanderwillner/unc2url/?branch=master)[![GitHub Issues](https://img.shields.io/github/issues/alexanderwillner/unc2url)](https://github.com/alexanderwillner/unc2url/issues)[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)[![GitHub Release](https://img.shields.io/github/v/release/alexanderwillner/unc2url?sort=semver)](https://github.com/alexanderwillner/unc2url/releases)[![PyPI - Downloads](https://img.shields.io/pypi/dm/unc2url?label=pypi%20downloads)](https://pypi.org/project/unc2url/)[![GitHub Download Count](https://img.shields.io/github/downloads/alexanderwillner/unc2url/total.svg)](https://github.com/alexanderwillner/unc2url/releases)

Convert between Microsoft Windows Uniform Naming Convention (UNC) paths and Uniform Resource Locator (URL) addresses.

Within typical IT environments, the installed operating systems might be heterogeneous. When a Windows user is sharing a network path with others, e.g. via e-mail, it might be in form of `\\server\path\to\file`. This UNC path, however, can't easily be opened by Linux and macOS clients (even Windows clients often have issues). This script converts the path into clickable URLs that can be used by all three operating systems. It takes care of white spaces, umlauts and other encoding issues.

## Table of Contents

- [Install](#install)

- [Examples](#examples)

- [Screenshots](#screenshots)

## Install

```sh

$ pip3 install unc2url

# or

$ git clone https://github.com/alexanderwillner/unc2url && cd unc2url && make install

```

## Examples

```shell

% # for Linux and macOS clients

% unc2url '\\example.org\foo\bar'

smb://example.org/foo/bar

% # for Windows clients

% unc2url --file '\\example.org\foo\bar'

file://example.org/foo/bar

% unc2url --reverse 'file://example.org/foo/bar'

\\example.org\foo\bar

% unc2url -h

usage: unc2url.py [-h] [-r] [-f] [--version] unc

Simple UNC to URL tool.

positional arguments:

  unc            An Uniform Naming Convention (UNC) link

optional arguments:

  -h, --help     show this help message and exit

  -r, --reverse  Reverse the conversation (url2unc)

  -f, --file     File URL (file://)

  --version, -v  show program's version number and exit

```

## Alfred Workflow

To activate this workflow use the default keyword ```unc2url``` and enter the UNC you want to get translated. You can also press a hotkey (⌘+⇧+U, but this has to be configured by the user) to translate what is in your clipboard. Pressing ⇧+Enter will open the SMB link and pressing Enter will copy the translations to the clipboard:

```text

file://server/foo/bar

smb://server/foo/bar

```

![Alfred](resources/alfred.png)