Browse Source

Adds supporting files

master
sloum 11 months ago
parent
commit
0d813c04d5
3 changed files with 98 additions and 0 deletions
  1. +24
    -0
      LICENSE
  2. +18
    -0
      Makefile
  3. +56
    -0
      README.md

+ 24
- 0
LICENSE View File

@ -0,0 +1,24 @@
This is free and unencumbered software released into the public domain.
Anyone is free to copy, modify, publish, use, compile, sell, or
distribute this software, either in source code form or as a compiled
binary, for any purpose, commercial or non-commercial, and by any
means.
In jurisdictions that recognize copyright laws, the author or authors
of this software dedicate any and all copyright interest in the
software to the public domain. We make this dedication for the benefit
of the public at large and to the detriment of our heirs and
successors. We intend this dedication to be an overt act of
relinquishment in perpetuity of all present and future rights to this
software under copyright law.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
For more information, please refer to <http://unlicense.org/>

+ 18
- 0
Makefile View File

@ -0,0 +1,18 @@
GOCMD := go
BINARY := borrow
PREFIX := /usr/local
EXEC_PREFIX := ${PREFIX}
BINDIR := ${EXEC_PREFIX}/bin
MANDIR := ${DATAROOTDIR}/man
MAN1DIR := ${MANDIR}/man1
.PHONY: build
build:
${GOCMD} build -o ${BINARY}
.PHONY: install
install: build
install -d ${DESTDIR}${BINDIR}
install -m 0755 ./${BINARY} ${DESTDIR}${BINDIR}

+ 56
- 0
README.md View File

@ -0,0 +1,56 @@
# Borrow
Download albums from bandcamp. The program will only use the publicly generated URLs that get used for streaming, as a result only the 128kbps/16-bit files are available. These are files that would be put on your computer as a part of streaming the songs from the site anyway. Additionally, it will only download songs that are freely streamable, not ones that there is no stream for but come with an album purchase. That said, the authors of this software make no claims regarding the legality of its usage in your jurisdiction and, per the license terms, are not liable for your usage of the software. During creation and testing of the software only music for which the authors were legal rights holders was downloaded.
## Usage
```sh
borrow -path /home/someuser/Music/ https://someband.bandcamp.com/album/somealbum
```
Using the above, borrow will extract the artist, album, and track names and save the files to the given path. The path is optional and the current directory will be used if it is not present.
You can, at your option, override the artist and album names with the `-artist` and -album` flags.
Check out `borrow -h` for info.o
Borrow will utilize golang's concurrency features to download the files at the same time (concurrently), so it should be pretty snappy.
## Building
You just need a go compiler then run `make` to build to the current directory or `sudo make install` to install it.
## License
This software is available under the terms of "The Unlicense". A file with the text has been included in the repo, but I will include it here as well:
```
This is free and unencumbered software released into the public domain.
Anyone is free to copy, modify, publish, use, compile, sell, or
distribute this software, either in source code form or as a compiled
binary, for any purpose, commercial or non-commercial, and by any
means.
In jurisdictions that recognize copyright laws, the author or authors
of this software dedicate any and all copyright interest in the
software to the public domain. We make this dedication for the benefit
of the public at large and to the detriment of our heirs and
successors. We intend this dedication to be an overt act of
relinquishment in perpetuity of all present and future rights to this
software under copyright law.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
For more information, please refer to <http://unlicense.org/>
```

Loading…
Cancel
Save