Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/agmmnn/fineartdown
Download high-resolution images from Fine Art America, Conde Nast Store, Photos.com, and Pixels.com. "the current reverse engineering approach is non-functional."
https://github.com/agmmnn/fineartdown
dezoomify downloader fineart fineartamerica image museum
Last synced: about 2 months ago
JSON representation
Download high-resolution images from Fine Art America, Conde Nast Store, Photos.com, and Pixels.com. "the current reverse engineering approach is non-functional."
- Host: GitHub
- URL: https://github.com/agmmnn/fineartdown
- Owner: agmmnn
- Created: 2023-03-07T22:17:04.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2023-12-20T13:07:31.000Z (about 1 year ago)
- Last Synced: 2024-10-25T22:34:06.144Z (about 2 months ago)
- Topics: dezoomify, downloader, fineart, fineartamerica, image, museum
- Language: TypeScript
- Homepage: https://npmjs.com/package/fineartdown
- Size: 65.4 KB
- Stars: 26
- Watchers: 8
- Forks: 2
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
> _Note: It seems that some folks from fineartamerica.com have seen the repo and made changes that affect the functionality of the reverse engineering approach used in this repository. Please be aware that the current code may not work as expected._
# FineArtDown
Download full size images from **[Fine Art America](https://fineartamerica.com/)**, **[Conde Nast Store](https://condenaststore.com/)**, **[Photos.com](https://photos.com/)** and **[Pixels.com](https://pixels.com/)**. You can check results in the _[Results Gallery](./Gallery.md)_.
## How to Use
1. Download the executable from [Releases](https://github.com/agmmnn/fineartdown/releases).
1. Open your terminal in the path where the executable file is located.
1. Run the command: `./fineartdown-[your-os] `
```
> ./fineartdown-win https://fineartamerica.com/featured/dancing-octopus-barathieu-gabriel.html
```
### Or from npm
```
npm install -g fineartdown
fineartdown
```
### Or run locally:
```
gh repo clone agmmnn/fineartdown
cd fineartdown
pnpm i
pnpm fineartdown
```
## How to Use (Non-technical users, Windows)
1. Download the executable from [Releases](https://github.com/agmmnn/fineartdown/releases).
2. Navigate to the folder where the executable file is located. Once you have located the folder, hold down the **Shift** key on your keyboard and **right-click** on an empty space within the folder. This will open a context menu.
3. In the context menu, you should see an option that says _"Open PowerShell window here"_ or _"Open command window here"_ or _"Open Terminal"_ depending on your Windows version. Select this option, and a new terminal window will open next to the exe file.
> Note: If you don't see the these options you can install [Windows Terminal](https://apps.microsoft.com/store/detail/windows-terminal/9N0DX20HK701) from Microsoft Store.
4. Run the command: `./fineartdown-[your-os] `
5. Press enter to run the command, and the program will download the image to your current directory.
## How it works?
The backend server sends a 10% smaller slice of the requested tile with 10% upscale.
- User: Request: 600px.
- Server: Send 10% less slice of the user's selection, upscaled by 10%. Response: 540px to 600px.
[](https://fineartamerica.com/featured/saint-tropez-boucherie-slim-aarons.html)
So we need 3 layers to fill most of the gaps between the tiles.
[layer1, layer2, layer3]
A 4th layer can be added, but this requires more requests to the server. And the server does not return the image more than a certain number of requests in a certain period of time. This time we have to put a delay between each download, which makes the total process longer. Using different proxy ip's can be a solution.
[](https://fineartamerica.com/featured/saint-tropez-boucherie-slim-aarons.html)
- [540, 600, 667] = [(600\*0.9),600,(600/0.9)] : Disadvantages: Need to upscale 600px->667px. So much float numbers in backend and gap numbers. Advantages: Less tiles=less requests to the server.
- [486, 540, 600] = [((600\*0.9)\*0.9),(600\*0.9),600] : I've tried many combinations and this is the best one so far.
> You can make calculations using the [calculator project](./calculator-project/).
## Known Problems:
### Gaps Between Tiles:
There are still gaps between tiles. Because 3 layers cannot cover the whole picture. As I mentioned before, adding the 4th layer takes a lot of time. _Different layer sizes or different image sizes create different patterns._
1. The first type of gap is a rectangular gap caused by the layers not covering the entire surface.
2. The second type of gap is caused by downsizing the 600px layer to 599. Because the server is actually sending 1 pixel lower probably due to the decimal values widthmedium and heightmedium. (it took me a long time to figure it out)
This can be solved with the Healing Brush Tool in Photoshop.
### Limited Request to Server
The server sends the content "---" instead of the image after a certain number of requests within a certain period of time. Therefore, I added a rule to the download function that if it fails, it retries after a certain delay. That's why it takes longer to download an image.
## Results
> You can find more results in the [Results Gallery](./Gallery.md).
[](https://fineartamerica.com/featured/models-sitting-on-sand-dunes-clifford-coffin.html)
[](https://fineartamerica.com/featured/the-vision-of-the-valley-of-dry-bones-gustave-dore.html)